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Safety Considerations 



GENERAL - This product and related documentation must be re- 
viewed for familiarization with safety markings and instructions before 
operation. 



SAFETY SYMBOLS 

Instruction manual symbol: the product will be marked 
with this symbol when it is necessary for the user to 
refer to the instruction manual in order to protect the 
product against damage. 



Indicates hazardous voltages. 




* 



WARNING 



The WARNING sign denotes a hazard. It calls attention to 
a procedure, practice, or the like, which, if not correctly 
performed or adhered to, could result in injury. Do not 
proceed beyond a WARNI NG sign until the indicated con- 
ditions are fully understood and met 



Example of Warning 



i Indicates earth (ground) terminal (sometimes used 
4s in manual to indicate circuit common connected to 
grounded chassis). 



CAUTION 

The CAUTION sign denotes a hazard. It calls attention to an 
operating procedure, practice, or the like, which, if not cor- 
rectly performed or adhered to, could result in damage to or 
destruction of part or all of the product Do not proceed be- 
yond a CAUTION sign until the indicated conditions are fully 
understood and met. 



Example of Caution 



WARNING 

SERVICING - Any servicing, adjustment, maintenance, or 
repair of this product must be performed only by qualified 
personnel. 

Adjustments described in this manual may be performed 
with power supplied to the product while protective cov- 
ers are removed. Energy available at many points may, if 
contacted, result in personal injury. 

Capacitors inside this product may still be charged even 
when disconnected from its power source. 

To avoid a fire hazard, onlly fuses with the required cur- 
rent rating and of the specified type (normal blow, time 
delay, etc.) are to be used for replacement 



CAUTION 



Example of Warning 



STATIC SENSITIVE DEVICES - Some of the semiconduc- 
tor devices used in this equipment are susceptible to dam- 
age by static discharge. Depending on the magnitude of the 
charge, device substrates can be punctured or destroyed by 
contact or mere proximity to a static charge. These charges 
are generated in numerous ways such as simple contact, 
separation of materials, and normal motions of persons 
working with static sensitive devices. 

When handling or servicing equipment containing static 
sensitive devices, adequate precautions must be taken to 
prevent device damage or destruction. Only those who are 
thoroughly familiar with industry accepted techniques for 
handling static sensitive devices should attempt to service 
the cards with these devices. In all instances, measures 
must be taken to prevent static charge buildup on work sur- 
faces and persons handling the devices. Cautions are in- 
cluded through this manual where handling and mainte- 
nance involve static sensitive devices. 



WARNING 



EYE HAZARD - Eye protection must be worn when remov- 
ing or inserting integrated circuits held in place with re- 
taining clips. 



Preface 

The SCSI Card Installation and Reference Manual describes how to install the SCSI hardware 
and software, and how to use the product. It also provides information to help you write your own 
device drivers. Consequently, the RTE-A Driver Reference Manual, part number 92077-90011, 
and the RTE-A System Generation and Installation Manual, part number 92077-90034, do not 
contain SCSI card driver information. 

Similarly, the HP 24612A diagnostic manuals do not contain any information that applies only to 
the SCSI Card diagnostic. The documentation strategy of putting all of the required product 
information in one manual is new and we hope that you find it a definite improvement. Please use 
the Reader Comment sheet at the front of this manual to send us your opinion and your 
comments. 

Please read the README file on the software media that comes with the product for information 
about software revisions and software media part numbers, and for descriptions of additional 
software. 

Throughout the manual, the term SCSI Card is used for the term Hewlett-Packard 12016A Small 
Computer Systems Interface Host Bus Adapter Card. 
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General SCSI Information 



This chapter introduces the HP 12016A Small Computer System Interface Host Bus Adapter 
Card (SCSI Card) and contains the following information: 

An overview of the SCSI Card. 

A list of the equipment provided with the card. 

Tested products. 

Manuals and guides related to the host system (the HP 1000). 

Product specifications. 

The README file on the software media that comes with the SCSI product contains information 
about software revisions and software media part numbers, and descriptions of additional soft- 
ware. 



SCSI Card Overview 

The HP SCSI Card connects SCSI or SCSI-II compatible peripheral controllers to an HP 1000 
A-Series computer. You can connect up to seven controllers for disk drives, magnetic tape drives, 
printers and other peripherals to the SCSI Card. The SCSI Card supports both single-ended and 
differential SCSI bus configurations. 

The RTE-A Operating System controls concurrent SCSI peripheral transactions on multiple buses 
while maintaining compatibility with non-HP peripherals. Testing has not been performed on all 
possible SCSI peripherals and software device drivers; however, many peripherals and device 
drivers that conform to the current state of the SCSI specifications are compatible with the SCSI 
Card. 

Connection to Peripherals 

The standard 12016A card comes with a single-ended two-meter cable that connects the SCSI in- 
terface card to the SCSI bus. The A-Series end of the cable connects to the card (connector P3) 
with an 80-pin female printed circuit edge connector; the other end of the cable connects to a 
50-pin D-type connector on the SCSI bus. 

Some SCSI devices require a differential bus, which 12016A option 001 supplies. The single-ended 
cable does not come with this option. Option 001 includes a cable that connects to differential 
devices and uses a 50-pin D-type connector. 
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You cannot mix single-ended and differential devices on the same SCSI interface. If you want to 
connect both single-ended and differential devices, you need two SCSI Cards. 

Appendixes B, C, and D describe the pin-to-signal designations for the single-ended cable, differ- 
ential cable, and card connector P3, respectively. 

Software 

The SCSI Card and software are compatible with HP 1000 A-Series Computers operating under 
the RTE-A Operating System (revision 5010 or later). 

Three drivers come with the HP SCSI Card. The interface driver, EDQ35, couples the SCSI Card 
to the RTE-A Operating System. The disk device driver, DDQ30, generates the device-dependent 
commands required to support HP disks. A generation record file, DDQ30_GEN, provides the 
default generation records for products supported by the DDQ30 device driver. The tape device 
driver, DDQ24, generates tape device commands and DDQ24_GEN provides the default genera- 
tion records for products the DDQ24 driver supports. You must install at least one device driver 
in order for the interface to communicate with the devices. 



NOTE 

All Optical Disks must be formatted prior to use on an HP 1000 comp uter. You 
can use the online verification program, VSCSI to format disks, as described in 
Chapter Four. 



You can write your own special device drivers to connect the devices. This manual and the disk 
device driver source code file DDQ30.MAC contain the information necessary to write your own 
device drivers. In addition, you can contract with Hewlett-Packard to obtain any necessary con- 
sulting to write device drivers. However, Hewlett-Packard assumes no responsibility for user-writ- 
ten device drivers. 



Equipment Checklist 



There are two 12016A SCSI Card configurations, one for standard (single-ended) devices and one 
for differential devices. You cannot mix single-ended and differential devices on one SCSI inter- 
face card. The standard HP 12016A SCSI Card product comes with the following hardware: 

• SCSI Interface Card, part number 12016-60001. 

• SCSI Interface Cable, part number 12016-60002. 

• Cable Terminator, part number 1252-3251. 

• Fuse, part number 2110-0517, 2 amps, 125 volts. This extra fuse is provided in case the 
on-board fuse opens. 

• HP 12016A SCSI Host Bus Adapter Card Installation and Reference Manual, part number 
12016-90001. 
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The HP 12016A SCSI Interface product, option 001 (for differential target devices), comes with 
the following hardware: 

• SCSI Interface Card, part number 12016-60001. 

• SCSI Interface Differential Cable, part number 12016-60003. 

• Differential Cable Terminator, part number 12016-80003. 

• Fuse, part number 2110-0517, 2 amps, 125 volts. This extra fuse is provided in case the 
on-board fuse opens. 

• HP 12016A SCSI Host Bus Adapter Card Installation and Reference Manual, part number 
12016-90001. 

You can order four different types of additional connecting cables with the SCSI product. Con- 
necting cables HP 92222A (.5 meters / 1.6 feet), HP 92222B (1 meter / 3.3 feet) and HP 92222C (2 
meters / 6.6 feet) connect SCSI peripheral devices together. These three cables connect (daisy 
chain) one SCSI device to another SCSI device; they do not connect the SCSI interface cable to a 
device. 

The fourth type of cable you can order is a one meter (3.3 feet) extender cable, part number 
92222D. This cable connects to the SCSI cable itself to extend its length. Cable HP 92222D does 
not interconnect SCSI devices, it only extends the length of the SCSI interface cable. 

The SCSI Card has three peripheral media options. Each media option includes an Interface 
Driver (IDQ35), supported device drivers and an online verification program (VSCSI). 

Three software media options are available with the SCSI Card (for more information, please 
read the README file on the software media): 

Option Description 



#022 CS/80 Cartridge Tape 

#051 1600 BPI Magnetic lape 

#044 3.5" Microfloppy Disks 

You can order the SCSI Card without the Installation and Reference manual (option 100). 
However, you cannot delete the manual from product orders that include a software media op- 
tion. 

All of the HP SCSI peripheral media software options contain the following drivers and verifica- 
tion program: 

IDQ35.REL, SCSI Interface Driver IDQ35 (Relocatable). 
DDQ30.REL, Disk Device Driver (Relocatable). 
DDQ30.MAC, Disk Device Driver (Source Code). 
DDQ30_.GEN.REL, Disk Generation Records (Relocatable). 
DDQ30_GEN.MAC, Disk Generation Records (Source) 
DDQ24.REL, Tape Device Driver (Relocatable) 



General SCSI Information 1-3 



DDQ24J3EN.REL, Tape Generation Records (Relocatable) 

VSCSI.REL, Online Verification Program (Relocatable). 

VSCSILIB.REL, MACRO/1000 support routine 

ZRAMTST.HEX, downloaded Z180 RAM test 

ZLPBK.HEX, downloaded Z180 Loop Back test 

SCSI.SNF, SCSI software numbering file. 

README, a file that contains a description of additional software provided with the SCSI 
product, and information about software media part numbers and software revisions. The 
software is from RTE-A and other subsystems that complement the SCSI device. Read this 
file for more information. 

The Disk Device Driver source code and relocatable are included to provide an example of a 
SCSI device driver to help you write your own driver(s). 



Tested Peripheral Devices 



HP Series 6300 Model 650/A Rewritable Optical Disk Drive, C1701A (single-ended only). 
HP Series 6000 Model 660S Hard Disk, with options for DAT and rewritable optical disk. 
HP Series 6000 Model 330S Hard Disk, with options for DAT and rewritable optical disk. 
HP Series 6400 Model 1300/S Digital Audio Tape Drive. 



Supported Drivers 



Table 1-1 lists the SCSI drivers and the devices they support. 



Peripheral Device 



Table 1-1. Supported SCSI Drivers 
Interface Driver 



Device Driver 



Rewritable Optical Disk 

Hard Disk 

Digital Audio Tape (DAT) 



EDQ35 
IDQ35 
IDQ35 



DDQ30 
DDQ30 
DDQ24 



Related Manuals 

The following technical documents associated with the HP 1000 computer are available from 
Hewlett-Packard. 

RTE-A System Generation and Installation Manual, part number 92077-90034. 
HP lOOOA-Series Computer I/O Interfacing Guide, part number 02103-90005. 
RTE-A Programmers Reference Manual, part number 92077-90007. 
RTE-A Driver Reference Manual, part number 92077-90011. 
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RTE-A Driver Designer's Manual, part number 92077-90019. 
Computer reference manual for your HP 1000 computer. 

Schematics, parts lists, and serviceable parts lists are not provided in this manual because the HP 
SCSI Card is a Field Replaceable Unit (FRU). 

Specifications 

This section describes the physical and environmental specifications for the SCSI Card. This sec- 
tion also contains a list of national and international regulatory approvals. 

Physical Specifications 

Dimensions: 

Length: 28.9 cm (11.38 inches) 

Width: 17.2 cm ( 6.75 inches) 

Weight: 720 gm (25.3 ounces) 

Standards: 

Conforms to Hewlett-Packard's implementation of HP SCSI. 

Electrical 

Power Requirements: 

1.0A at 5.1V, 5.1 Watts (includes TERMPOWER) 
15maat + 12V 0.18 Watts 
15ma at -12V, 0.18 Watts 

Power Source: 

This product generates termination power. It is designed to supply the power to 
the termination network at each end of the cable. The termination network at the 
computer end is integrated onto the card. The power available to the user is 
greater than 4.5 volts at up to .5 amps. 

Maximum Bus Data Rate 

2.56 megabytes per second 
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Environmental Specifications 

The HP SCSI Card meets or exceeds the specifications of its HP 1000 host. Refer to the installa- 
tion and service manual for your computer. 

Temperature 



Operating 

Storage 

Relative Humidity 



to 55 degrees C 

-40 to 75 degrees C 

5% to 95% noncondensing 



Altitude 



Operating 
Non-Operating 



To 4.6 km (14,088 ft) 
To 15.3 km (50,284 ft) 



Regulatory Approvals 

The HP SCSI Card meets or exceeds the following EMI and safety standards when correctly 
installed in an HP 1000: 



FCC Class A 
VDE Level A 
CISPR22 Class A 
UL478 
CSA220 
IEC380 



(USA EMI) 
(Germany EMI) 
(International EMI) 
(USA Safety) 
(Canada Safety) 
(International Safety) 
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Hardware Installation 



This chapter describes how to install the HP 12016A SCSI Card and also describes the SCSI 
Card self-test. Installation procedures include checking the product for shipping damage and 
completeness, setting the switches, installing the card, and connecting the cables. Customers who 
follow the step by step instructions in this chapter can install the SCSI Interface hardware. Cus- 
tomers who do not wish to install the card can contact the local HP sales office for assistance. 



CAUTION 

Wear an anti-static wrist strap connected to a ground during all phases of 
handling and installing the SCSI Card. Failure to wear properly grounded 
anti-static wrist straps will result in static electricity damaging components on 
the card. 



Pre-lnstallation Tasks 

This section describes shipment receiving procedures and how to return the product, if necessary. 

Unpacking and Inspecting the SCSI Card 

Always wear properly grounded anti-static wrist straps when you handle the SCSI Card. Inspect 
the snipping cartons for visible damage. If visible damage exists, immediately submit a damage 
report to the carrier company and to Hewlett-Packard (or an authorized HP dealer). Follow the 
repacking procedures described later in this chapter to return the card, if necessary. 

Make sure that the shipment you receive agrees with the product list on the shipping documents 
and that the contents of the cartons match the parts listed in Chapter One under the heading 
"Equipment Checklist." If any items are not included, immediately notify Hewlett-Packard. 
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Reshipping Instructions 

If it is necessary to reship the HP SCSI Card, contact your nearest HP Sales and Support Office 
to coordinate the product's return. Attach a tag to the card explaining the reason for returning the 
product. Include your computer's model number and full serial number on the tag. Mark the ship- 
ping container "FRAGILE" to ensure careful handling. In any follow-up correspondence, please 
refer to your computer by model and serial number. 

If possible, use the original packing material. If the original packing material is not available, use 
a commercially available anti-static shipping package, or purchase one from your nearest HP 
Sales and Support Office. 



Installation Procedures 

This section describes how to install the HP SCSI Card in your system. Figure 2-1 shows a typical 
SCSI Card installation in an HP 1000 computer. 

Required Tools 

To install the HP 12016A SCSI Card, all you need are the tools necessary to open the back door 
of your computer. 

Power Budgeting 

All cards installed in the HP 1000 put a load on the computer power supply. The HP SCSI Card 
draws 1.0 ampere at 5.1 volts. To ensure that the additional power drawn by the SCSI Card is 
within the power budget of your computer, refer to the installation and reference manual for your 
computer to find the computer's power supply requirements. 

SCSI Card Layout 

Figure 2-2 shows the layout of the SCSI Card, including the locations of the switches, the 
on-board fuse, the SCSI firmware PROM, the self-test LEDs (Light Emitting Diodes) and edge 
connectors PI, P2 and P3. Use this diagram to locate the switches you need to set before you in- 
stall the SCSI card. 

Do not use the modular jack shown in Figure 2-2. The modular jack is for Hewlett-Packard test- 
ing only, not for customer use. If you connect a telephone to this jack, you can damage the SCSI 
Card. 
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I/O Cards 
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Notes: 

1 . The above diagrams show typical installations of the SCSI card in a 20-slot box configuration. 
The SCSI card can be installed similarly into a 6-slot or 16-slot box. 

2. Only one SCSI card is shown in each computer. Multiple SCSI cards can be installed in the 
backplane in any priority slot. 

3. The first I/O slot to the right of the CPU for an A900 configuration is not shown although the 
SCSI card is supported in that slot. 



Figure 2-1 . SCSI Card Typical Installation 
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Figure 2-2. SCSI Card Layout 
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Switch Settings 

This section describes how to set the two SCSI Card switches that specify the card's select code, 
address, and enable bus termination power. 



CAUTION 

Wear a properly grounded anti-static wrist strap during all phases of handling 
and installing the SCSI Card. Failure to wear properly grounded anti-static 
wrist straps will result in static electricity damaging components on the card. 



The SCSI Card has two 8-position switches. Switch SW1 specifies the select code of the card and 
enables SCSI bus TERMPWR (bus termination power) from the card. Switch SW2 defines the 
card's SCSI address. Before you install the card, set these two switches. The open (up) position ==• 
1. The closed (down) position = 0. Figure 2-3 shows an example of switch settings for SW1 and 
Figure 2-4 shows an example of switch settings for SW2. 

Setting Switch SW1 

Configure the eight switches on SW1 as follows: 

SW1-1 Reserved, must be in the open (up) position. 

SW1-2 Leave in closed (down) position to enable TERMPWR from the 

card. When SW1-2 is in the down position, the SCSI Card supplies 
the voltage for the SCSI bus terminators. If you open this switch 
(up position), the SCSI Card does not supply TERMPWR. In this 
case, another device on the SCSI bus must supply TERMPWR. 
Only one device on the SCSI bus should supply TERMPWR. 

SW1-3 through 8 Specifies the card's interface select code. You cannot have duplicate 

select codes in the backplane. Ensure that the select code you 
specify here is unique. Switch 3 of SW1 is the most significant bit. 
Switch 8 is the least significant bit. All interface cards must have 
unique I/O select codes ranging from 20 to 77, inclusive. However, 
note that for the A400 computer, the on-board I/O is hardwired to 
select code 77. 
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Switch SW1 Positions 




Switch Number 



BitS 7 6 5 4 3 2 1 

Reserved Select Code 

TERMPWR enable 



Switch Number 



Octal Value 



1 



40 20 10 



Figure 2-3. SW1 Settings 

Figure 2-3 shows reserved switch SW1-1 in the open (up) position and SW1-2 in the closed (down) 
position. Switches SW1-3 through 8 specify the SCSI Card's select code. In this case, the example 
select code is 22 octal (switches 4 and 7 are open). This select code is only an example; the select 
code you use may differ. 

Setting Switch SW2 

Configure the eight switches on SW2 as follows: 



SW2-1 through 5 
SW2-6 through 8 



Reserved, leave in closed (down) position. 

These three switches determine the SCSI Card address. Switch 8 is 
the least significant bit. For a single initiator system (a card with 
one host computer and one to seven peripherals), the recommended 
setting is 7, as shown in Figure 2-4 (Switches 6 through 8 are open.) 



Switch SW2 Positions 




Switch Number 



Reserved SCSI Card address 



Switch Number 



Octal Value 



Figure 2-4. SW2 Settings 
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SCSI Card On-Board Fuse r 

The SCSI Card has a customer replaceable, two ampere, 125-volt on-board fuse, part number 
2110-0517, to protect the card from shorts on the SCSI bus. See Figure 2-2 for the location of the 
fuse on the SCSI Card. Hewlett-Packard provides an extra fuse with the SCSI product (both the 
single-ended and differential versions) for your convenience. 

This fuse can open if power is not turned off while you are connecting a cable to the device. This 
is one reason why it is very important to ensure that all power is off when you install the SCSI 
card and its cables, including power to all peripheral controllers on the SCSI bus. 

The SCSI Card fuse is socketed so that it can be replaced easily. 

Card Installation 

This section describes how to install the SCSI Card in an HP 1000 computer. 



CAUTION 

Turn off power to the computer before installing the interface card and cables. 
If there is a battery BACKUP switch, set it to DISABLE. Failure to turn the 
power off and disable the battery BACKUP switch may result in damage to the 
interface card or attached I/O device. 

Wear a properly grounded anti-static wrist strap during all phases of handling 
and installing the SCSI Card. Failure to wear properly grounded anti-static 
wrist straps will result in static electricity damaging components on the card. 

WARNING 

High current may be present. Failure to turn off power before opening the 
computer may allow contact with energy that may result in personal injury. 



Take the following steps to install the SCSI Card: 

1. Turn the computer's power OFF (0) at the LINE ON/OFF switch and disconnect the power 
cord. Check for a battery backup switch and set it to disable. 

2. Remove or open the back door of your HP 1000 computer. 

3. After setting the appropriate switches according to the previous instructions, slide the inter- 
face card into a slot in your computer's I/O backplane. The card's components should face 
upward or to the right, depending on whether your computer has vertically or horizontally 
oriented slots. Make sure that you do not leave any empty slots above or to the right of the last 
I/O card in the backplane. Empty slots between cards break the DMA (Direct Memory Ac- 
cess) and interrupt priority chains. The closer the card is to the CPU (by ascending slot or- 
der), the higher its DMA and interrupt priorities. 
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4. Firmly and evenly press the card into the backplane until edge connectors PI and P2 slide 
completely into the backplane edge connectors. Figure 2-2 shows the locations of edge con- 
nectors PI and P2. Ensure that the extractor handles facing the computer's back door do not 
bind on the card cage. 

5. Replace the back door if you are not going to install the cables at this time. If you are going 
to install the cables now, leave the back door open and follow the steps; described in the 
"Cable Installation" section. 



Cable Installation 

A single-ended or differential cable (part numbers 12016-60002 and 12016-60003, respectively) 
connects the HP SCSI Card to the bus. Do not connect a single-ended cable to a differential de- 
vice, or vice versa. This does not damage the hardware, but will cause data errors. Do not connect 
the SCSI cable to any connector except as described in this section. Connecting a SCSI cable to 
the wrong connector may open the fuse on the SCSI Card. 

See Figure 2-1 for a diagram of a typical HP SCSI Card installation. To connect the SCSI cables, 
take the following steps: 

1. Ensure that the computer's power and battery enable switch are off, that the peripheral pow- 
er is off, and that the power cable is disconnected. If the computer's back door is closed, re- 
move or open it. 



CAUTION 

Power supply voltages (5Vdc) exist in the SCSI cable. POWER MUST BE 
TURNED OFF! Failure to heed this caution will result in damage to the 
equipment and will open the fuse on the card — ensure that computer and 
peripheral device power is off. 



2. Connect the other end of the cable to the first device on the SCSI bus. 

3. Connect the hooded cable connector to the edge connector of the SCSI Card, with the cable 
leading toward the right, or toward the bottom for a 20-slot card cage. 

4. Close and secure the computer's back door. The computer's back door must be closed to 
ensure proper cooling and EMI compliance. 

5. Connect additional devices to each other. 

6. Plug the terminator into the last cable connector of the last physical unit on the SCSI bus. 
Make sure that your terminator matches your devices and cable. That iis, the cables and de- 
vices all must be single-ended or differential, but not a combination of the two. 

7. Reconnect the power cable to the computer, set the LINE ON/OFF switch to ON (1), set the 
battery backup to enable, turn on the peripheral(s), and reboot your system. 

The HP 12016A supports one bus terminator at the end of the bus string with the interface card 
at the other end. The interface card contains terminations for its end of the cable. The card does 
not support a bus "T" configuration because the card's termination resistors are soldered in. 
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Verification of Correct Installation 

Use the following checklist to troubleshoot problems that may occur during the installation and 
operation of the SCSI Card. 

1. Check that the SCSI Card is seated firmly in the HP 1000 backplane. 

2. Verify that the cable to the SCSI Card is properly connected. 

3. Verify that the bus terminator is properly connected. 

4. Turn on system power. 

5. Check the four Light Emitting Diodes (LEDs) to see whether the self-test has been success- 
fully completed or not. Refer to Table 2-5, under the heading "Self-Test", for definitions of the 
LED test patterns. 

6. Verify correct completion of HP 1000 computer microcode and VCP self-tests. Refer to the 
installation and service manual for your computer for the LED test patterns. 



SCSI Self-Test 

A self-test program resident in PROM on the SCSI Card runs automatically when you turn on the 
power, reset the computer, or execute the %P or %T commands from the VCP prompt. The 
self-test performs the following tasks: 

1. Verifies the integrity of the firmware in PROM. 

2. Performs a simple test of the SCSI card on-board memory. 

3. Tests the SCSI protocol interface chip for its ability to communicate with the SCSI Card 
microprocessor. 

The SCSI self-test program does not check the device cable or the ability to communicate with the 
HP 1000. The host processor's self-test tests the backplane communication between the SCSI 
Card and the host processor. 
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Four red Light Emitting Diodes (LEDs) display SCSI Card status and report errors (if any) that 
result from the SCSI self-test. The LEDs are located on the SCSI Card (see Figure 2-2 for a dia- 
gram of the SCSI Card layout). Table 2-5 shows the possible self-test LED patterns and their defi- 
nitions. 







Table 2-5. LED Self-Test Status 


LED 


LED 


LED 


LED 


Status 


1 


2 


3 


4 


OFF 


ON 


ON 


ON 


Card PROM Checksum Error 


OFF 


ON 


ON 


OFF 


RAM Test Failed 


OFF 


ON 


OFF 


ON 


Reserved 


OFF 


ON 


OFF 


OFF 


DMA Test Failed 


OFF 


OFF 


ON 


ON 


Timer Test Failed 


OFF 


OFF 


ON 


OFF 


SCSI Chip Test Failed 


OFF 


OFF 


OFF 


ON 


Reserved 


OFF 


OFF 


OFF 


OFF 


Passed Test * 


BLINK 


OFF 


OFF 


OFF 


Normal Operation ** 



* The all-LEDs-off condition that indicates successful self-test completion only exists briefly; 
after this, LED number one blinks continuously, which indicates a normally functioning 
SCSI Card. 

** The rate at which LED one blinks indicates the activity of the card. Faster blinking indicates 
an idle card. Slower blinking indicates a heavier load on the card. A rate as low as several 
seconds between blinks is normal. 

You can see whether or not the SCSI Card has passed the SCSI self-test by checking the LEDs. A 
frozen LED pattern (the LEDs' pattern does not change and some LEDs are in a steady "on" 
condition) denotes a self-test failure. When the card passes the self-test, all of the LEDs briefly 
turn off. After this occurs, LED number one begins to blink, which indicates a normally function- 
ing SCSI card. 

If the SCSI Card fails the self-test, record the frozen self-test LED pattern, then return the card to 
Hewlett-Packard as described in this chapter under "Reshipping Instructions". The SCSI Card is 
not a user-repairable unit. If the card does not function correctly, please return it to 
Hewlett-Packard for repair or replacement. 

If the SCSI Card passes the self-test and the LEDs remain off, the card is malfunctioning. Cycle 
the power to reinitiate the SCSI self-test. 
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Card Removal 

Take the following steps to remove the HP SCSI Card from the HP 1000 backplane. 



CAUTION 

Turn off power to the computer and peripherals before removing the interface 
card and cables. If there is a battery BACKUP switch, set it to DISABLE 
before removing the hardware. Failure to turn off power and disable the 
battery BACKUP switch may result in damage to the interface card or 
attached I/O device. 

WARNING 

High current may be present. Failure to turn off power before opening the 
computer may allow contact with energy that may result in personal injury. 



1. Set the computer's power OFF (0) at the LINE ON/OFF switch and disconnect the power 
cord. Check for a battery backup and set the switch to disable. Turn off power to any con- 
nected peripherals. 

2. Remove or open the back doors of the computer. 

3. Unplug the SCSI cable from the interface card. 



CAUTION 

Wear a properly grounded anti-static wrist strap during all phases of handling 
and removing the SCSI Card. Failure to wear properly grounded anti-static 
wrist straps will result in static electricity damaging components on the card. 



4. Use the two extractor levers on the card edge to remove the SCSI Card from the backplane. 

5. Slide the card out of the card cage. 

lb ensure the integrity of the DMA and interrupt priority chains, make sure that you do not leave 
a vacant card slot. Vacant slots between cards break the DMA and interrupt priority chains. If 
this occurs, your system will not function. 

6. Replace and secure the back door. 
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Software Installation 



This chapter describes how to install the HP SCSI Driver software, including boot preparation 
procedures. You can also use this procedure as a general guideline to install your own device driv- 
er. To install the SCSI software, you need to be familiar with the RTE-A Operating System. You 
also must be familiar with the generation process, and you must know how to boot your computer 
and how to use the Edit/1000 editing program. If you do not have this type of experience, do not 
install the software yourself. Find a qualified person who has the experience to install the soft- 
ware. For additional information, refer to the RTE-A System Generation and Installation Manual, 
part number 92077-90034. 

Before you install the software, we recommend that you back up your entire system and preserve the 
original copies of the system, snap, and answer files. Do not delete the existing system — preserve it, 
just in case errors occur during software installation. If you are not familiar with the computer's 
operating system, we recommend that a Hewlett-Packard Customer Engineer (CE) or other quali- 
fied person install the SCSI software. 

Take the following steps to install the SCSI software: 

1. Copy the software from the shipped media to your system. 

2. Create a new answer file based on your current answer file and preserve the old file. Add the 
SCSI changes to the new file. 

3. Run the generator, RTAGN, on the new answer file. 

4. Copy the system and snap files to the /SYSTEM directory, but do not overwrite or replace 
the old system files. 

5. Create a new Boot Command file while preserving the old Boot Command file; create a new 
Welcome file while preserving the old Welcome file. 

6. Reboot the system, specifying the new Boot Command file. 

7. Verity correct system operation, then rename and preserve the old files; rename the new files 
to their permanent names. 

The following sections describe each of these steps in detail. 
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Copying the Software 



The HP SCSI peripheral media software includes the following drivers and programs (plus addi- 
tional files): 

IDQ35.REL, SCSI Interface Driver (Relocatable). 

DDQ30.REL, Disk Device Driver (Relocatable). 

DDQ30.MAC, Disk Device Driver (Source Code). 

DDQ30_GEN.REL, Disk Generation Records (Relocatable). 

DDQ30_GEN.MAC, Disk Generation Records (Source Code). 

DDQ24.REL, lape Device Driver (Relocatable) 

DDQ24_GEN.REL, lape Generation Records (Relocatable) 

VSCSI.REL, The SCSI Online Verification Program. 

VSCSIUB.REL, MACRO/1000 Support Routine 

ZRAMTST.HEX, Downloaded Z180 RAM Test 

ZLPBK.HEX, Downloaded Z180 LOOPBACK Test 

SCSI.SNF, Software Numbering File (describes each piece of software that comes with 

the SCSI product). 
README, a text file that contains information regarding additional software shipped 

with the SCSI product. 

The way you copy the software depends on what kind of medium you ordered with the SCSI 
product. 

To copy the SCSI software from CS/80 cartridge tape or 1600 BPI Magnetic Tape, create a direc- 
tory called /SCSI, then copy the software to the /SCSI directory as follows: 

ci> crdir /scsi <lu> (creates the /SCSI directory on < lu >. Ensure that 

the LU you select has enough space for the SCSI 
software, which uses approximately 2,000 blocks.) 

CI> wd /scsi 

CI> fst 

fst> mt <lu> (where < lu > is the LU number of your tape drive) 

FST> re @ 

FST> go 

FST> ex 

To copy the SCSI software from microfloppy disks, create a directory called /SCSI, then copy the 
software to the /SCSI directory as follows: 

Ci> crdir /scsi <lu> (creates the /SCSI directory on < lu >. Ensure that 

the LU you select has enough s pace for the SCSI 
software, which uses approximately 2,000 blocks.) 

CI> wd /scsi 
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Insert the first floppy into the drive, then enter the following commands: 

ci> mc <lu> (where < lu > is the LU number of your microfloppy 

drive) 

CI> co /f/scsi/ /scsi/ 
CI> dc <lu> 

Remove the first floppy from the drive, insert the next floppy, then enter the following commands: 

ci> mc <lu> (where < lu > is the LU number of your microfloppy 

drive) 

CI> co /f/scsi/ /scsi/ 
CI> dc <lu> 

The procedures described above copy the drivers and files to the /SCSI directory. To load the ad- 
ditional software described in the README file, list the README file and follow the instructions 
it contains. 



Create a New Answer File 

Take the following steps to create a new answer file that includes the SCSI changes. Make sure 
that you follow the steps to preserve your current answer file. 

1. Create a new answer file by copying your current answer file to 
/SCSI/YourFavoriteName.ans. Make sure that you do not delete your old answer file. 

2. If you are installing a hard disk or a rewritable optical disk, read the source file 
DDQ30_GEN.MAC to gain an understanding of the GEN records that will be used in the 
DVT statements in the next step. 

3. Copy the files IDQ35.REL, DDQ30.REL, DDQ30_GEN.REL, DDQ24.REL, and 
DDQ24_GEN.REL to the /RTE_A directory. Edit YourFavoriteName.ans to add the follow- 
ing: 

a. Decide upon the LUs for the device(s). The LU numbers must fall within the range 1-63, 
inclusive. 

b. In the OS/Driver partitions section of the System Relocation Phase, add the appropriate 
RE lines. You do not need to add both of the device driver lines unless you have both disk and 
tape devices. Add the line RE IRTEAIDDQ30.REL to support disk devices, and the line RE 
IRTE_AIDDQ24.REL to support tape devices. 

RE /RTE_A/IDQ35.REL 
RE /RTE_A/DDQ30.REL 
RE /RTE_A/DDQ24 . REL 

Note that you can partition the drivers or not partition the drivers, as you desire. 
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A physical disk is the actual hardware upon which your data is r<;corded, such as the HP 
92280 disk cartridge used in the 650/A drive. RTE allows you to subdivide the total disk 
storage into logical disks of more manageable size, if necessary, because the capacity of 
the physical drive may not be appropriate for your application. The DVT (Device Table) 
statements in your answer file define these physical disk subdivisions. Refer to the 
DDQ30_GEN.MAC source code if you need more information to choose the correct 
DVT statement entries. 

c. In the Table Generation Phase, add an IFT (Interface lable) statem ent f or each SCSI 
Card in your syste m. If you have one SCSI Card, you will have one IFT statement, and 
so on. Below each IFT statement, add one DVT statement for each device LU on the in- 
terface, in the format shown below. For disk device driver DDQ30, make sure that you 
set driver parameter 8 (Blocking Factor) to match your disk drive's physical block size. 
The following example shows statements for a system with two SCSI Cards with both 
disk and tape device drivers. 



Note 

The bold numbers (the LU and select code numbers) are examples only. They 
are not necessarily the LUs and select codes you will use. The DDQ30 lines of 
these examples assume HP 92280A (1024 byte sectors). Lines with am asterisk 
(*) indicate comments, not generation instructions. 



IFT /RTE_A/IDQ35.REL sc:22b 

* Device #1 (SCSI address 0) 

* 

DVT /RTE_A/DDQ30_GEN.REL ml28mb:0, lu:30, dp: 1:0, dp: 8: 3 
DVT /RTE_A/DDQ30_GEN.REL ml28mb:l, lu:31, dp: 1:0, dp: 8: 3 
DVT /RTE_A/DDQ30_GEN.REL m51mb_3:b, lu:32, dp: 1:0 
* 

* Device #2 (SCSI address 1) 

DVT /RTE_A/DDQ24_GEN.REL, , lu:33, dp: 1:1 

IFT /RTE_A/IDQ35.REL sc:23b 

* 

* Device #1 (SCSI address 0) 

* 

DVT /RTE_A/DDQ30_GEN.REL ml28mb:0, lu:34, dp: 1:0, dp: 8: 3 
DVT /RTE_A/DDQ30_GEN.REL ml28mb:l, lu:35, dp: 1:0, dp: 8: 3 
DVT /RTE_A/DDQ30_GEN.REL m51mb_3:b, lu:36, dp: 1:0 

* 

* Device #2 (SCSI address 1) 

* 

DVT /RTE A/DDQ24 GEN.REL, , lu:37, dp: 1:1 
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Each IFT statement indicates an interface card. If you have three SCSI Cards in your computer, 
you will need three IFT statements in the new answer file. 

You must associate at least one DVT statement with each IFT statement, as shown in the pre- 
vious example. Interfaces without DVT statements cannot communicate with any devices. 

System Generation 

To generate the system, enter the following command: 

CI> rtagn , / SCSI /Your Favor i teName . ans ,-,-,- 

Note that you must use the .ans extension in order to use the dashes to indicate the default sys- 
tem, snap, and list files. The file names default to YourFavoriteName.sys, YourFavoriteName.snp, 
and YourFavoriteNamclst, respectively. 

If system generation is successful, the message "Zero Errors*' appears on the screen. 

If system generation is not successful, an error message appears on the screen. Check the modifi- 
cations you made to your answer file to ensure that you did not make any errors. 

Copy System and Snap Files to the /SYSTEM 
Directory 

When system generation completes without errors, enter the following commands to copy the sys- 
tem and snap files to the /SYSTEM directory: 

CI> co YourFavoriteName.sys /system/© 
CI> co YourFavoriteName.snp /system/© 

Create New Boot Command and Welcome Files 

The following steps describe how to create new Boot Command and Welcome files while preserv- 
ing your current files: 

1. Copy your current Boot Command file to /SYSTEM/YourFavoriteName.cmd. 

2. Copy your current Welcome file to /SYSTEM/Welcomexx.cmd, where xx is any number from 
0-99, inclusive, that is not used for another Welcome file. 

3. Edit the " < file > .sys" and " < file > .snp" commands in your new Boot Command file 
(YourFavoriteName.cmd) to refer to your new system and snap files. 

4. Edit the "st„xx" command in your new Boot Command file (YourFavoriteName.cmd) to ref- 
erence the new Welcome file (Welcomexx.cmd). 
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Reboot the System 



Press the BREAK key to get the VCP prompt, then reboot the system, specifying the new Boot 
Command file, for example: 

VCP> %bdc27<YourFavoriteName.cmd> 

The number 27 is the select code of the device from which you are booting. Select code 27 is used 
here as an example only. 

If you have a 650/A Rewritable Optical Disk Drive installed, you can also use the "mc, < lu > " 
command to mount your SCSI LUs. When the LUs are mounted, you can create directories on 
your new SCSI device and copy software to it. 

Finalizing the Software Installation 

Confirm that the new LUs have been generated by executing the IO command. Next, manually 
verify that the new disks are functioning correctly by running the online verification test (VSCSI). 
You can do this by entering the following command at the CI > prompt: 

CI> vscsi <lu> -all 

This command executes six SCSI verification tests and displays the test results on screen. For 
more information about VSCSI, see Chapter Four under the heading "Online Verification Pro- 
gram"; see Chapter Four under the heading "Non-Interactive Interface" for a description of the 
-all command. 

Perform the following commands to finalize your software installation: 

1. Rename your old system files to preserve them, for example, 

CI> rn Boot.cmd OLD_BOOT . cmd 
Do not delete your old files! 

2. If it is appropriate, edit Welcomexx.cmd to mount the new disk LUs you defined when you 
created the new answer file. 

3. Rename your new system files to the standard names. 
Your SCSI software is now installed. 
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Troubleshooting 



This chapter describes troubleshooting procedures for the SCSI Card. It includes a troubleshoot- 
ing checklist, and descriptions of the SCSI self-test and the VSCSI verification program. 



Troubleshooting 



Use the following checklist to troubleshoot problems that may occur during the installation of an 
HP SCSI Card. 

1. Make sure that the card is seated firmly in the backplane. 

2. Make sure that the cables to the card are tightly and properly connected. 

3. Verify that the SCSI bus terminator is correctly installed. 

4. Make sure that the power to the SCSI devices is on. 

5. Run a self-test by cycling the computer's power or using the %P or %T commands from the 
VCP prompt. If the SCSI Card fails the self-test, record the self-test LED pattern, then 
return the card to Hewlett-Packard as described in Chapter Two under the heading "Reship- 
ping Instructions". The SCSI Card is not a user-repairable unit. If the card does not function 
correctly, please return it to Hewlett-Packard for repair or replacement. 

SCSI Self-Test 

When you turn power on, reset the computer, or execute the %P or %T commands from the VCP 
prompt, the SCSI microprocessor executes the SCSI self-test firmware. The program runs the fol- 
lowing tests: 

• Checks the integrity of the firmware in PROM. 

• Performs a simple test of the SCSI Card on-board memory. 

• Tests the SCSI protocol interface chip for its ability to communicate with the SCSI Card 
microprocessor. 
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The SCSI self-test program does not check the device cable or the ability to communicate with the 
HP 1000. The host processor's self-test tests the backplane communication between the SCSI 
Card and the host processor. 

Four red Light Emitting Diodes (LEDs) display SCSI Card status and report errors (if any) that 
result from the self-test. The LEDs are located on the SCSI Card (see Figure 2-2 for a diagram of 
the SCSI Card layout). Table 4-1 shows the possible self-test LED patterns and their definitions. 







Table 4-1. LED Self-Test Status 


LED 


LED 


LED 


LED 


Status 


1 


2 


3 


4 


OFF 


ON 


ON 


ON 


Card PROM Checksum Error 


OFF 


ON 


ON 


OFF 


RAM Test Failed 


OFF 


ON 


OFF 


ON 


Reserved 


OFF 


ON 


OFF 


OFF 


DMA Test Failed 


OFF 


OFF 


ON 


ON 


Timer Test Failed 


OFF 


OFF 


ON 


OFF 


SCSI Chip Test Failed 


OFF 


OFF 


OFF 


ON 


Reserved 


OFF 


OFF 


OFF 


OFF 


Passed Test * 


BUNK 


OFF 


OFF 


OFF 


Normal Operation ** 



* The all-LEDs-off condition that indicates successful self-test completion only exists briefly; 
after this, LED number one blinks continuously, which indicates a noimally functioning 
SCSI Card. 

** The rate at which LED one blinks indicates the activity of the card. Faster blinking indicates 
an idle card. Slower blinking indicates a heavier load on the card. A rate as low as several 
seconds between blinks is normal. 

You can see whether or not the SCSI Card has passed the SCSI self-test by checking the LEDs. 
A frozen LED pattern (the LEDs' pattern does not change and some LEDs are in a steady "on" 
condition) denotes a self-test failure. When the card passes the self-test, all of the LEDs briefly 
turn off. After this occurs, LED number one begins to blink, which indicates a normally function- 
ing SCSI card. 

If the SCSI Card fails the self-test, record the self-test LED pattern, then return the card to 
Hewlett-Packard as described in Chapter Two under the heading "Reshipping Instructions". The 
SCSI Card is not a user-repairable unit. If the card does not function correctly, please return it to 
Hewlett-Packard for repair or replacement. 

If the SCSI Card passes the self-test and the LEDs remain off, the card is malfunctioning. Cycle 
the power to reinitiate the SCSI self-test. 
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Online Verification Program 



This section describes the SCSI online verification program (VSCSI), how to initiate it, its two 
user interfaces, the tests you can run, and possible error messages. VSCSI is an RTE-A applica- 
tion program which verifies that the SCSI Card is functioning correctly. 

The verification program provides two different interfaces: 

1. An Interactive Interface. Using this interface, you can enter commands that run specific veri- 
fication tests, one test at a time. You can also specify the number of times to run each test. 
The test results are displayed on screen after you run each test. After a test runs, a command 
prompt reappears, and you can run another test or exit the program. 

2. A Non-Interactive Interface. To use the non-interactive interface, specify the tests you want 
to execute and the number of times to execute the tests in the VSCSI runstring. You can run 
all tests or just selected tests. As VSCSI runs in non-interactive mode, the test results appear 
on screen, then the program terminates. You can run the non-interactive verification program 
from CI command files. You can test $RETURN1 to see if the program executed successfully 
(the result is for success; a non-zero return is failure). 

VSCSI Usage Help 

You can get help at the CI prompt by entering 

CI> vscsi 

at the prompt without specifying an LU number or any other parameters. When you get help, the 
following program usage message appears on screen: 

Usage: VSCSI [SCSILU] [-1] [-V] [-HP] [-L LOGFILE] [-LOOP COUNT] 

[-ALL] [-SELFTEST] [-DI] [-ID] [-FMP] [-TERMPWR] [-TIMESTAMP] 
[-DEVFLAG] [-RAMTEST] [-LOOPBACK] 

-I = ignore errors; -V = verbose; -HP = non-HP terminal 
-L LOGFILE = echoes messages to user specified LOGFILE 
-LOOP COUNT = repetitively executes specified tests 

Specifying one or more of the following tests causes VSCSI to execute non-interactively 
(and callable from a CI CMD file). Otherwise VSCSI executes interactively with the user 
entering commands at a prompt. 

-ALL = all tests (except SELFTEST and LOOPBACK) 

-SELFTEST (or -SE) = on-board SELFTEST 

-DI = Display lus with vendor-model information 

-ID = BOARD ID test 

-FMP = FMP test 

-HMESTAMP (or -TS) = TIMESTAMP test 

-TERMPWR (or -TE) = TERMPWR test 

-DEVFLAG (or -DE) = check device flag operation 

-RAMTEST(or-RAM) = SCSI board RAM test (32KB-5 12KB) 

-LOOPBACK = LOOPBACK test (requires test hood) 
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Interactive Interface 

The SCSI verification program has online commands that you can execute when you run the SCSI 
verification program in interactive mode. To call the interactive version of the verification pro- 
gram, at the CI prompt enter 

CI> vscsi [scsilu] [optional nontest parameter] [optional nontest parameter] 

where VSCSI calls the verification program and [scsilu] is the logical unit number of one of the 
SCSI device LUs associated with the SCSI Card you are testing. You can include any or all of the 
following optional nontest parameters in the runstring when you call the interactive version of the 
verification program. If you enter any test parameter in the runstring, you invoke the non-interac- 
tive version of the program (see the section titled "Non-Interactive Interface" in this chapter for 
more information): 

-HP This parameter notifies the verification program that the terminal 

is not a Hewlett-Packard terminal. This means that cursor position- 
ing ( < ESC > + < a > column c row R), homeup ( < ESC > + 
< h > ) and clear screen ( < ESC > + < j > ) are not supported. 

-V This parameter specifies verbose mode. Verbose mode displays 

information on screen about what the program is doing. 

-I This parameter tells the program to ignore all errors and continue 

with the verification program tests. This command is especially 
useful when you use the loop command to rum commands repeti- 
tively. When you specify this parameter in the runstring, the pro- 
gram prints error messages on screen, then continues to run tests, 
instead of printing the error message and aborting. You could use 
the loop command to run a test many times (for example, 30,000 
iterations) and find out from the on screen messages how many 
failures occurred, without interrupting the program. We recommend 
that you use the -I parameter in conjunction with the -L < logfile > 
parameter, so that you have a record of all e:rrors encountered. 

-L < logfile > This parameter produces a log file that records the verification test 

results. The "-L" indicates that the next parameter is the name of 
the log file. The parameter < logfile > is the name of the log file. 
You can specify a full path name to produce the log file in a direc- 
tory other than the working directory. If you do not specify a path 
name, the log file is created in the working directory. Note that if a 
file with the specified name already exists, it will be overwritten. 

It is possible to call the verification program in interactive mode without specifying an LU 
number if you specify one or more of the four parameters described above (-HP, -V -I or -L 
< logfile > ) in the runstring, but without test parameters. (The section titled "Non-Interactive 
Interface*' in this chapter describes runstring test parameters.) 

When you call up the interactive interface, the command prompt vscsi : appears on screen. You 
can execute the following commands from the prompt: 
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?, ??, HELP Any of these three commands displays a list of all valid commands 

with brief descriptions. 

LU [scsilu] Defines the card you will test with the verification program, where 

[scsilu] is an LU number associated with a device on the SCSI 
Card. This command enables you to test different LUs without 
having to exit the verification program. For example, the command 
"LU 42" tells the verification program to verity the SCSI Card to 
which LU 42 is assigned. 

If you do not specify an LU number and there is already an LU 
number specified, the program displays the message 

SCSI LU = xx 

where xx is the current LU number. If you do not specify an LU 
number and no LU number was specified in the runstring, the 
program displays the message 

SCSI LU undefined. Use "LU < lu > " command. 

where < lu > is the SCSI LU number. 

FORMAT Formats the disk associated with the current SCSI LU (for example, 

the Rewritable Optical Disk). This command also performs a disk 
initialization function as part of the formatting process, so that the 
disk is ready to use after formatting is complete. (The CI IN com- 
mand is part of the formatting procedure.) The initialization pro- 
vides the data structure necessary to access files and a description 
of which areas are available. Use this command to format disks 
before using them with the SCSI system. To format a disk, enter 

VSCSI: format 

at the command prompt. The message 

Formatting the SCSI drive will DESTROY all data on the 
disk. This includes all LUs defined for the drive!!! 

OK to proceed [no] ? 

appears on screen. No is the default response. To abort the format, 
press the RETURN key, which displays the message 

FORMAT not performed. 

To proceed with the format, enter yes or OK at the prompt. The 
program displays the message 

Formatting .... Please be patient. 
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to indicate that the format has begun. When the disk format is 
complete, the program displays the message 

FORMAT complete. 

If you attempt to format a SCSI drive that contains mounted LUs, 
the program displays the message 

One or more lus on the SCSI drive are mounted. 
Unable to format drive. 

This message means that either the LU you want to format is 
mounted, or another LU with the same SCSI ID may be mounted, 
preventing your format command from executing. You can check 
this by executing the DISPLAY command, lb dismount an LU, exit 
to the CI prompt, then execute a dismount command. When you 
use the format command, all LUs on the disk will be formatted. 



CAUTION 

If an LU is mounted, it is already formatted. Other users may be using the LU 
or have files on the LU. The FORMAT command affects ALL LUs on the 
drive, not just the LU that VSCSI is using to refer the board/drive. All data on 
the drive will be destroyed. 



DISPLAY 
ORDI 



Displays a list of the LUs associated with the SCSI Card, 
including the address, the device's vendor and model and its 
current status. The following diagram is an example of what the 
DISPLAY command shows on screen; the numbers and status 
shown are examples only. 



lu 



Addr 



SCSI Verification Program 

Vendor -Model 



Rev.5022 



Status 



50 





HP 


S6300.650A 


Mounted 


51 





HP 


S6300.650A 


Device Down 


52 





HP 


S6300.650A 




53 





HP 


S6300.650A 




54 


1 


HP 


2212A 


Not Connected 


55 


1 


HP 


2212A 


Not Connected 


XX 


2 






No Lu defined 



IFT select code: 71 
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In this display, "lu" is a list of the LU numbers associated with the 
SCSI Card, "Addr" lists the SCSI addresses, "Vendor-Model" gives 
the device vendor and model designations, and "Status" shows the 
current status of the LU. 

The Status field in the display screen can contain one of the follow- 
ing messages: 

Mounted — the LU is mounted to the FMP system. 

Device Down — the RTE-A operating system considers this LU 
down, as indicated by DVT word 6. 

Not Connected — this LU is generated into the RTE-A system, but 
is not attached to the SCSI bus. 

No lu defined — an LU is not defined for this SCSI device (it is 
possible that the switches on the device are incorrectly set). 

inquiry failed — this is a device failure. VSCSI was not able to 
retrieve Vendor-Model information from the device. 



NOTE 

If TERMPWR is not on, the Vendor-Model field displays the message 
"Unavailable". 



UP < lu > Notifies the system that an LU is available. < lu > is any valid SCSI 

LU number. For example, RTE-A takes a device down when an er- 
ror such as a time-out occurs. The LU will not be available again 
for use until you execute an UP command. It does not cause an er- 
ror if you use UP on a device that is not down. 

VERBOSE [on/off] or This command turns verbose mode on and off from the command 

VE [on/off] line. Verbose mode displays more information on screen about what 

the program is doing (current status) and how the program is doing 
it. If you enter this command without the [on] or [off] parameter, a 
message that shows whether verbose mode is currently on or off 
appears. 
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LOOP [n] or 
REPEAT [n] 



Defines how many times to execute the SELFTEST FMP, ID, 
T1MESTAMP, TERMPWR, RAMTESX LOOPBACK and 
DEVFLAG test commands described below, [n] is the number of 
times to repeat the subsequent test commands you enter at the 
command prompt — you can repeat a command a maximum of 
32,767 times. To force commands to execute repeatedly, type LOOP 
or REPEAT at the command prompt, then type the number of 
times you want subsequent commands to run. After you enter a 
LOOP or REPEAT command, every subsequent FMP, ID, TIME- 
STAMP, TERMPWR, DEVFLAG, RAMTESX LOOPBACK and 
SELFTEST command executes the number of times you specified. 
To return to executing those commands only once, type LOOP or 
REPEAT with one (1) as the number of times to repeat the test. If 
you enter the LOOP or REPEAT command without specifying a 
number of times to repeat, the current loop count appears on 
screen. 

For example, if you enter the command 
VSCSI : loop 4 

then all subsequent commands that looping affects are executed 
four times, until you change the repeat/loop number. If you enter 
the command 

VSCSI : f mp 

after entering LOOP 4, the program issues four FMP calls and dis- 
plays the results. Any subsequent commands that can repeat also 
repeat four times. If you then enter the command 

VSCSI: loop l 

the command repeat factor returns to one. "Xbu could use REPEAT 
4 and REPEAT 1 instead of LOOP 4 and LOOP 1 to get the same 
results. 



SELFTEST or SE 



FMP 



ID or 
REVCODE 



DEVFLAG or DE 



Issues a hard reset command (OTA 32B) to the SCSI Card to 
force it to execute the SCSI self-test. 

Issues FMP calls to the SCSI LU to check the overall functioning 
of the SCSI Card, disk and cables. Tests incl ude mounting and dis- 
mounting the disk and reading directories. This command does not 
isolate any faults to the main SCSI components (the SCSI Card, the 
SCSI disk or the SCSI cable). Note that this test takes several sec- 
onds to execute; a message appears on screen to notify you that the 
test is executing. 

Displays the ID and revision code of the SCSI Card. The ID of the 
SCSI Card is 115. This tests the SCSI Card's I/O processor and 
select code switch. 

Checks device flag operation. 
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TERMPWR or TE 



Displays the status of the termpower status bit. 



HMESTAMP or TS 



Displays the SCSI Card's firmware timestamp and address. The 
timestamp field is formatted as YYMMDD.MMNN, where 
YYMMDD is the year, month and day of the firmware release, and 
MM and NN are the major and minor firmware revision codes. The 
SCSI Address field contains the address of the SCSI Card itself, 
which should be 7. VSCSI obtains this value from switch SW2 on 
the SCSI Card (see Chapter Two for more information on switch 
settings). 



RAMTEST or RAM 



LOOPBACK 



EXIXQUTT 
or ABORT 



Tests SCSI Card RAM (32KB - 512KB). This test only reports 
"PASSED" or "FAILED". The RAMTEST requires the file 
"ZRAMTST.HEX" to be located in the /PROGRAMS, /SYSTEM, 
/SCSI or working directory. 

The LOOPBACK test requires a test hood, part number 
12016-60007, which you can order from your local sales office. If 
you do not have the test hood, the message "LOOPBACK test 
FAILED" appears. The LOOPBACK test also requires the file 
"ZLPBK.HEX" to be located in the /PROGRAMS, /SYSTEM, 
/SCSI or working directory. 

Exits the interactive verification program. 



If you enter an invalid command, the message "Unknown command. Use ?? for help" appears. 

Non-Interactive Interface 

This section describes the tests that run when you call the SCSI verification program in non-inter- 
active mode. You can call the non-interactive mode verification program from a CI command file. 
To call the verification program in non-interactive mode at the CI prompt enter: 

CI> vscsi <scsilu> [optional parameter] [optional parameter] . . . 

where VSCSI calls the verification program and <scsilu > is the LU number of one of the SCSI 
device LUs associated with the SCSI Card you are testing. In the runstring, you can enter any 
number of optional parameters, which are described below. The non-interactive verification pro- 
gram runs the tests specified by the parameters, then exits back to the CI prompt. Unless you tell 
the program to ignore errors (how to do this is described below), the program terminates on the 
first failure, leaving an error message on screen. 

Omitting test parameters from the runstring calls the interactive version of the verification pro- 
gram. Specifying any test (-SELFTEST -FMP, -ID, -DEVFLAG, -TERMPWR, -TIMESTAMP, 
-DISPLAY, -RAMTESX -LOOPBACK or -ALL) in the runstring invokes non-interactive mode. 
The optional parameters you can specify when you call the non-interactive version of the verifica- 
tion program are as follows: 
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-L <logfile> 



-HP 

-V 

-I 



-LOOP [n] 



-SELFTEST 
or-SE 



-DISPLAY or -DI 



This parameter produces a log file that records the verification test 
results. The "-L" indicates that the next parameter is the name of 
the log file. The parameter < logfile > is the: name of the log file. 
You can specify a full path name to produce the log file in a direc- 
tory other than the working directory. If you do not specify a path 
name, the log file is created in the working directory. Note that if a 
file with the specified name already exists, it will be overwritten. 

This parameter notifies the verification program that the terminal is 
not a Hewlett-Packard terminal. This means; that cursor positioning 
(<ESC> + <a> column c row R),homeup(< ESC > + <h>) 
and clear screen ( < ESC > + < j > ) are not supported. 

This parameter specifies verbose mode. Verbose mode displays 
more information on screen about what the program is doing. 

This parameter tells the program to ignore all errors and continue 
with the verification program tests. It is meaningful only when you 
specify a loop count of more than one in the: runstring. When you 
specify this parameter, the program prints error messages on 
screen, then continues to run the tests specified in the runstring. 
You could use the -LOOP parameter to run a test many times (for 
example, 30,000 iterations) and find out from the on screen mes- 
sages how many failures occurred, without interrupting the pro- 
gram. We recommend that you use this parameter in conjunction 
with the -L < logfile > parameter, so that you have a record of all 
errors encountered. 

Defines how many times to execute the -SE1 JFTESX -FMP, -ID, 
-TIMESTAMP, -TERMPWR, -RAMTESX -DISPLAY, -ALL, 
-LOOPBACK and -DEVFLAG, command parameters described 
below, [n] is the number of times to repeat amy of these commands 
entered as parameters in the verification program runstring — you 
can repeat a command a maximum of 32,767 times. To force com- 
mands to execute more than once, enter -LOOP and a number in 
the verification program runstring. For example, the runstring 

CI> vscsi 33 -loop 4 -fmp 

calls the program in non-interactive mode for LU 33, executes the 
FMP test four times, then exits to the CI prompt. 

This parameter forces a hard reset of the SCSI Card (OTA 
32B) to run the SCSI self-test when you call the verification pro- 
gram. (The self-test is described earlier in this chapter under the 
heading "Self-Test".) If you do not specify this parameter, the verifi- 
cation program does not execute the SCSI self-test as part of the 
verification process. 

Displays a list of the LUs associated with this SCSI Card, 
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including the address, the device's vendor and model and its 
current status. The DISPLAY command description in the section 
titled "Interactive Interface" in this chapter shows a diagram of the 
display screen. The following diagram is an example of the display 
screen with all possible non-interactive runstring tests executed and 
their resul ts displayed (you can do this by specifying the -ALL and 
-SELFTEST commands in the runstring); the numbers and status 
shown are examples only. The runstring test results appear in the 
column on the right side of the screen. 



lu 



Addr 



SCSI Verification Program 
Vendor -Model 



Rev.5022 



Status 



50 





HP 


S6300. 


650A 


Mounted 


Board ID: 115 


51 





HP 


S6300. 


650A 


Device Down 


Board revision: 


52 





HP 


S6300. 


650A 




Select code: 71 


53 





HP 


S6300. 


650A 






54 


1 


HP 


2212A 




Not Connected 


TERMPWR: ON 


55 


1 


HP 


2212A 




Not Connected 


Cable: SINGLE -ENDED 


XX 


2 








No Lu defined 





IFT select code: 71 



Timestamp: 910110.0004 
SCSI addr: 7 

Self test PASSED. 
FMP test PASSED. 
RAM test PASSED. 



In this display, "lu" is a list of the LU numbers associated with the 
SCSI Card. In non-interactive mode, there is a limit of 15 LUs in 
the display, because the non-interactive display does not scroll. 
"Addr" lists the LU addresses, "Vendor-Model" gives the device 
vendor and model designations, and "Status" shows the current sta- 
tus of the LU. The right hand side of the display screen shows the 
IFT select code, the SCSI board ID, revision and select code, 
whether or not TERMPWR is on, and what type of cable is con- 
nected. In addition, the information from other VSCSI tests you are 
running is displayed in the right column. 

The Status field in the display screen can contain one of the follow- 
ing messages: 

Mounted — the LU is mounted to the FMP system. 

Device Down — the RTE-A operating system considers this LU 
down, as indicated by DVT word 6. 

Not Connected — this LU is generated into the RTE-A system, but 
is not attached to the SCSI bus. 



Troubleshooting 4-1 1 



No lu defined — an LU is not defined for this SCSI device (it is 
possible that the switches on the device are incorrectly set). 

inquiry failed — this is a device failure. VSCSI was not able to 
retrieve Vendor-Model information from the device. 

The Cable field in the right display column can contain one of the 
following messages: 

single -ended — A single-ended cable is attached and there are no 
differential devices on the bus. 

differential — A differential cable is attached and no single- 
ended devices are on the bus. 

DF cable -SE device — A differential cable: is attached, but the 
bus has a single-ended device or NO cable is attached to the 
SCSI card. 

SE cable -df device — A single-ended cable is attached, but 
there is at least one differential device on the bus. 



NOTE 

If TERMPWR is not on, the Vendor-Model field displays the message 
"Unavailable". 



-FMP 



-ID 



Issues FMP calls to the SCSI LU to check the overall functioning of 
the SCSI subsystem (card, disk, cables). Tests include mounting and 
dismounting the disk and reading directories;. This command does 
not isolate any faults to the main components (the SCSI Card, disk 
or cable). Note that this test takes several se<X)nds to execute; a 
message appears on screen to notify you thai: the test is executing. 

Displays the ID and revision code of the SCSI Card. The SCSI ID 
number is 115. This tests the SCSI Card's I/O processor and select 
code switch. 



-DEVFLAG or -DE 



Checks device flag operation. 



-TERMPWR or -TE 



Displays TERMPWR status and cable type. 



-TIMESTAMP or -TS 



Displays the SCSI Card's firmware timestarnp and address. The 
timestamp field is formatted as YYMMDD.MMNN, where 
YYMMDD is the year, month and day of the firmware release, and 
MM and NN are the major and minor firmware revision codes. The 
SCSI Address field contains the address of the SCSI Card itself, 
which should be 7. VSCSI obtains this value from switch SW2 on 
the SCSI Card (see Chapter Two for more information on switch 
settings). 
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-RAMTEST or -RAM Tests SCSI Card RAM (32KB - 512KB). This test only reports 

"PASSED" or "FAILED". The RAMTEST requires the file 
"ZRAMTST.HEX" to be located in the /PROGRAMS, /SYSTEM, 
/SCSI or working directory. 

-LOOPBACK The LOOPBACK test requires a test hood, part number 

12016-60007, which you can order from your local sales office. If 
you do not have the test hood, the message "LOOPBACK test 
FAILED" appears. The LOOPBACK test also requires the file 
"ZLPBK.HEX" to be located in the /PROGRAMS, /SYSTEM, 
/SCSI or working directory. 

-ALL Runs all verification program tests exce pt the SCSI self-test and 

loopback test. You can specify the -SELFTESX -I or -LOOP 
parameters in conjunction with -ALL. The -ALL parameter runs 
the -ID, -TERMPWR, -TTMESTAMP, -DISPLAY, -FMP and 
-DEVFLAG tests. 

For example, the SCSI verification program runstring 
CI> vscsi 41 -1 test, log -v -fmp 

calls up the non-interactive version of the verification program (because the test name -fmp was 
specified in the runstring) and specifies LU 41. The parameters tell the program to create a logfile 
called "testlog" in the working directory, to run in verbose mode, and to execute the FMP test. If 
a failure occurs, the program prints an error message on screen, then exits to the CI prompt. If no 
failures occur, the program runs the FMP test, then exits to the CI prompt. 

VSCSI Program Error and Information Messages 

VSCSI detects error conditions in SCSI operation. Errors can occur when attempting to validate 
the SCSI LU, during command parsing, in the runstring, and while attempting to access the SCSI 
LU. Additionally, errors can occur in relation to the SCSI self-test, FMP test, RAMTEST and 
LOOPBACK test, and in getting the firmware timestamp. The verification program also detects 
driver errors and provides several status messages. 

Most of the VSCSI status messages do not appear on screen unless you are running the program 
in verbose mode. Status messages are self-explanatory and simply inform the user about what the 
program is doing. For example, when you execute the FMP test, the message "FMP test executing. 
Please wait." appears. This message notifies you that the FMP test is running, because this test 
takes several seconds to execute. 

The non-interactive version of the verification program also returns an error code in the CI vari- 
able $returnl. The error code can be tested in CI command files. 



Error Messages During SCSI LU Validation 

The following error messages are related to validating the SCSI LU. When the verification pro- 
gram detects an LU validation error, it displays an error message, then the program terminates. 
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The program cannot display the LU table or any specific information, because the LU number 
entered in the runstring is illegal. 

SCSI LU not supplied 

Error: No SCSI LU number was included in the verification program runstring. This 
message appears only when you are invoking non-interactive mode. 

Solution: Enter a valid LU number in the runstring when invoking the verification pro- 
gram. 

SCSI LU undefined. Use "LU < lu > " command 

Error: In the interactive interface, you entered a hardware test command without 
specifying an LU number. This can occur if you invoke the interactive interface without 
specifying an LU number. For example, the runstring "VSCSI -V" invokes the interactive 
version of the verification program without an LU number. 

Solution: Use the LU command (described in the section titled "Interactive Interface" in 
this chapter) to specify a valid LU on which to run the test(s). 

LU xxx illegal. Valid range is 1 - maxlu 

Error: The SCSI LU number entered in the runstring or the LU number specified in the 
"LU" command is outside the range of valid LU numbers. The supplied LU number is 
either less than one or greater than the maximum LU generated into the system. The vari- 
able maxlu is the highest LU number generated into the system. 

Solution: Enter a valid LU number within the range the error message reported. 
LU xxx not assigned 

Error: The SCSI LU entered in the runstring or the command has a DVT (device table) 
address of zero. This means that the LU is not assigned to a device. 

Solution: Make sure that the LU number you enter is assigned to a. SCSI Card. 

LU xxx is wrong EFT type. Was xxxB, should be 35B 

Error: The SCSI LU entered in the runstring or the command (xxx) is not associated with 
the SCSI Card. The IFT (interface table) type associated with the given LU number (the 
first "xxxB" in the error message) is displayed along with the expected IFT type (35B). 

Solution: Enter an LU number that is associated with a SCSI Card!. This ensures that the 
IFT type will be correct. 
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Command Parsing Errors 

A command parsing error can only occur when using the interactive interface (no commands are 
parsed in the non-interactive interface — all of the commands are in the program runstring). 

Invalid LOOP value 

Error: A non-numeric value was entered with the LOOP or REPEAT command. This oc- 
curs when you enter any non-numeric value (any alphabetic character, punctuation mark 
or special character other than numbers) or invalid number as the number of times to 
repeat a command in command line mode. You can repeat commands up to 32,767 times. 

Solution: Enter a valid numeric value after the REPEAT or LOOP command. 

Unknown command 

Error: The command entered is unknown or misspelled. 

Solution: Enter the command again or use the HELP, ? or ?? command to get a list of 
valid commands. 



Runstring Parsing Errors 

A runstring parsing error can occur only when using the non-interactive interface (you do not en- 
ter commands in the runstring when using the interactive interface). 

Error In Specifying [-LOOP count] parameter 

Error: A non-numeric value was entered with the -LOOP parameter in the verification 
program runstring. This error is similar to the "Invalid LOOP value" error, except that it 
occurs in the runstring, not in the command line. 

Solution: Enter a numeric value after the -LOOP parameter in the runstring. 

Runstring parameter "[invalid parameter]" illegal 

Error: One or more parameters in the verification program runstring are illegal or invalid. 
The error message identifies the first illegal parameter in the runstring. 

Solution: Enter the runstring again, using only legal parameters. 

No LOGFILE name supplied 

Error: In the runstring, the parameter -L, which echoes the verification program test re- 
sults into a log file, did not have a LOGFILE file name following it. 

Solution: When you use the parameter -L in the runstring, make sure that you specify a 
file name for the LOGFILE data. 

SCSI LU Table Access Errors 

These errors occur when you invoke the ID, REVCODE, 1TMESTAMP (TS), DEVFLAG, FMP, 
TERMPOWER or SELFTEST commands without the correct select code specified in the verifi- 
cation program runstring. 
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DIAGNOSE MODE FAILED. SCSI Card not installed or has wrong select code 

Error: The verification program attempted to retrieve the SCSI Card's ID and revision 
code by entering diagnose mode 1 for the select code given in the EFT (interface table). 
Diagnose mode fails if the select code of the card does not agree with the select code in 
the IFT The CPU requires the installed card to have a select code equal to the select code 
in the IFE If the select codes are not the same, this error message appears. 

Solution: First make sure that there is an installed SCSI Card. If the card is installed in 
the system, make sure that it has a valid select code and is generated into the system cor- 
rectly, so that the SCSI Card's select code is equal to the select code in the IFT table. 
Switch SW1 determines the SCSI Card's select code (see Chapter Iwo under the heading 
"Switch Settings" for a detailed description of how to set the card's select code). 

Device Flag Cannot Be Cleared 

Error: This message indicates that the program found Flag 30B set and that a CLF 30B 
command (clear Flag 30B) did not clear the flag. 

Solution: This is a hardware failure; return the SCSI Card to HP. 

Self-Test Messages and Errors 

The following error messages can occur only when you invoke the SCSI Card self-test ("-SELF- 
TEST" parameter) in the verification program runstring. 

Performing a HARD RESET on card 

This is not an error message. This message indicates that the program is beginning the 
self-test portion of the verification tests. 

SELFTEST FAILED. Device flag not set within 10 seconds. 

Error: The verification program issued an OTA 32B command (hard reset) to force a 
SCSI Card self-test and waited for the device flag to be set. The flag was not set within 
the ten-second window (this time limit is defined by the VCP code. ) 

Solution: Perform a power cycle of the system and check the status of the LEDs on the 
SCSI Card. Refer to the section titled "SCSI Self-Test" in this chapter. 

FMP Test Errors 

FMP Device down. 

Error: The SCSI LU is down. 

Solution: Use the command "UP [scsilu]" to up the device. 
Miscompare error at record xxxx. 

Error: The FMP test failed. The text in record xxxx does not equal the expected value. 

Solution: Check record xxxx for errors. 
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In addition to these messages, errors that the FMP routines detect can report other error mes- 
sages. Refer to the RTE-A Programmer's Reference Manual, part number 92077-90007, for infor- 
mation about these errors. 



RAMTEST and LOOPBACK Test Errors 

The RAMTEST requires a file named "ZRAMTST.HEX" and the LOOPBACK test requires a 
file named "ZLPBK.HEX". These two files must be located in either the working directory, the 
/PROGRAMS directory, the /SYSTEM directory or the /SCSI directory. 

If the required files are not in one of the appropriate directories, the following message appears: 

No such file XXXXX.HEX 

where XXXXX.HEX is ZRAMTSTHEX if you are running the RAMTEST and ZLPBKHEX if 
you are running the LOOPBACK test. 

The following errors can appear in response to a corrupt .HEX file. The solution to all of these 
errors is to replace the corrupt .HEX file. 

Unexpected EOF 

Error: The end of the file was detected before the Intel END record was encountered. 
Record too short. 

Error: The record is shorter than 11 (eleven) bytes. 
Not INTEL Hex format. 

Error: The record contained non-hexadecimal characters. 
Record type must be or 1. 

Error: The Record Type field contained a value other than or 1. 

Checksum error. 

Error: The record is corrupt so that the sum of the length, address, type and data bytes 
did not equal the checksum value. 

Firmware Timestamp Errors 

The following errors can occur when the verification program attempts to get the firmware time- 
stamp. 

Timeout waiting for interrupt 

Error: The verification program did not receive the expected device flag (SFS sc) after 
sending the command to retrieve the firmware timestamp. 

Solution: Run the self-test to verify that this is a hardware failure. Return the SCSI Card 
to Hewlett-Packard if this condition persists. 
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Protocol error: Response FIFO empty 

Error: The verification program received the correct device flag after sending the com- 
mand to retrieve the timestamp, but the SCSI Card status word (L1A 32B) indicated that 
the response FIFO was empty. The verification program expects the response FIFO to 
contain the timestamp response, therefore, the response FIFO should not be empty. 

Solution: Run the self-test to verity that this is a hardware failure. Return the SCSI Card 
to Hewlett-Packard if this condition persists. 

Bad response type in returning timestamp 

Error: The response to the timestamp retrieval command did not contain the expected 
response type, which is 5. 

Solution: Verify that the proper drivers and firmware are installed. If this error persists, 
return the SCSI Card to Hewlett-Packard. 

SCSI Card not installed or select code incorrect 

Error: The global register on the SCSI Card is not set properly. This means that the 
switch setting for the card's select code is incorrectly set on switch SW1 or the select code 
is incorrectly generated in the interface table — that is, the select codes in the interface 
table and on the card itself are not the same. Because the select codes do not agree, the 
program cannot find the SCSI Card. 

Solution: Reboot the computer and check the list of SCSI Cards and their select codes to 
ensure that each select code is correctly set on SW1 and correctly generated into the sys- 
tem. 



Driver Errors 

Driver Error: TERMPWR not Enabled 

Error: The termination power is not enabled on the SCSI Card and is not enabled from 
any of the SCSI devices. 

Solution: Enable termination power from the SCSI Card as described in Chapter Two or 
enable termination power from one of the devices. 

If VSCSI detects driver errors when issuing EXEC calls to a SCSI device, VSCSI prints the error 
condition, but does not print the error number. Driver error messages are preceded by the text 
"Driver Error:", followed by a description of the error condition. Appendix A describes driver 
error messages and provides solutions for the errors. If the driver returns an error code unknown 
to VSCSI, VSCSI displays the error code in decimal. For example, an unknown error might be 
"Driver Error: 47 (decimal)". 

VSCSI prints the following errors originating in the device driver (the decimal error number is 
provided in this description, even though it is not reported on screen): 
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Error Number Error Message 



1 Illegal request. 

2 Device not ready. 

3 Device timeout. 

5 Transmission error. 

6 Device write protect. 

7 Address error. 
10 Disk fault. 

12 Insufficient driver table space. 

20 Disk not mounted. 

21 Wrong media; No disk in drive. 

22 Incompatible cartridge. 

23 Medium un-initialized or format corrupt. 

24 No spares available. 

25 Automatic re-allocation failed. 

26 Defect list update failed. 

27 Defect list not available. 

29 Illegal logical block address. 

62 Device busy. 

VSCSI prints the following errors originating in the interface driver (the decimal error number is 
provided in this description, even though it is not reported on screen): 

Error Number Error Message 

28 Protocol error. 

40 TERMPWR not enabled. 

41 Device driver bypassed on 1st call. 

42 Card SCSI address = Device SCSI address. 

43 Select error. SCSI device not on bus. 

44 CDB length or CDB type illegal. 

45 Firmware/driver rev codes incompatible. 



Other Errors 

Several other error messages can appear during VSCSI testing. For more information about these 
errors, refer to the RTE-A Programmer's Reference Manual, part number 92077-90007. 

FORMAT operation failed. 

Error: FORMAT operation did not succeed. This message appears in conjunction with 
other error messages that specify the exact error condition. 

System ABORTED call. Error code = AABB 

Error: An EXEC call was aborted. AA and BB are the contents of the A and B registers, 
respectively. 

TERMPWR missing. 

Error: A cable is not connected or a fuse has opened. 
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This chapter provides information on how to access SCSI devices from user-written application 
programs (such as device drivers), for everyday use of the SCSI Card. The examples in this chap- 
ter are given in FORTRAN. 



Card Communication Overview 

The SCSI Card communicates with firmware and drivers at several levels, as shown in Figure 5-1. 
This chapter describes the SCSI Card communication above the double line (above the 12016A 
SCSI Interface Card(s) level shown in the diagram). 



User Programs 



High Level Language file access 



File Management Package 



Device Driver 



Interface Driver 



12016A SCSI Interface Card(s) 



SCSI bus 



SCSI Device 



SCSI device 



SCSI device 



SCSI device 



Figure 5-1 . SCSI Card Communications Overview 

User programs can talk directly to the High Level Language file access (HLL), the File Manage- 
ment Package (FMP), the device driver(s) and the interface driver(s). The HLL can talk directly to 
the FMP, the device driver(s) and the interface driver(s). The FMP can talk directly to the device 
driver(s) and the interface driver(s). The device driver talks directly to the interface driver, which 
communicates with the SCSI Interface Card. 

This chapter covers only the device and interface driver EXEC calls, because the High Level 
Language and File Management Package (FMP) accesses are transparent. 
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Digital Audio Tape (DAT) Device Driver DDQ24 

The following sections describe tape device driver DDQ24, including Read and Write request 
calls, Z buffer calls and control request calls. 

DDQ24 Driver Read, Write and Control Calling Sequences 

You can execute read and write calls, Z-Buffer read and write calls, and control calls. Z-Buffer 
read and write calls enable you to construct bus transactions that are outside the range of the 
usual read and write transfers, such as tape eject requests. Control calls execute control com- 
mands. 

The calling sequences for these calls are as follows: 

Read: CALL EXEC (1,CNTWD,BUFR,BUFLN) 

Write: CALL EXEC (2,CNTWD,BUFR,BUFLN) 

Z-Read: CALL EXEC (l,CNTWD,BUFR,BUFLN,COMMAND,CC>MMANDLN) 

Z-Write: CALL EXEC (2,CNTWD,BUFR,BUFLN,COMMAND,CC>MMANDLN) 

Control: CALL EXEC (3,CNTWD,[PARM1]) 

Calling Sequence Parameters 

The first parameter is an integer, either 1, 2, or 3. This integer determines what type of call is be- 
ing made: 

"1" indicates a read, 
"2" indicates a write, 
"3" specifies a control call. 

The difference between the usual read/write calls and Z-read/Z-write calls is that the Z-Buffer 
calls include two extra parameters to specify the command and the command's length. All 
Z-read/Z-write driver calling sequences must include these two parameters. 

The second parameter is the "CNTWD" parameter, which is declared as a one word integer. You 
use the subfunction bits (11 through 6) of the "CNTWD" parameter differently for read and write 
requests than you do for control requests. All driver calling sequences must include this parame- 
ter. 



Control Word Bits: 


15 14 13 12 


11 


10 9 8 7 


6 


5 


4 3 2 10 


BB 


NB 


UE 


Z 


SubFunction 


Logical Unit Number 
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The following paragraphs describe the control word bits and their functions. 

15 BB BB stands for bypass bit. If set ( = 1), this bit allows you to bypass the tape de- 

vice driver and call the interface driver directly. We strongly recommend that you 
do not do this unless you are certain that you know what you are doing. 

14 NB NB stands for no buffer bit. If set, there is no buffer bit to inhibit output buffer- 

ing. This has no effect on the driver. 

13 UE UE stands for user error handling, which has no effect on the driver. Normally, 

this bit is not set, which enables the system to interpret errors and take action to 
correct them. If this bit is set, the user interprets errors and takes action to cor- 
rect them. 

12 Z Z stands for the Z-Buffer bit, which is a dual buffer bit. If set, this bit indicates 

that the call is a Z-Buffer read or write, instead of an ordinary read or write. It 
also adds two buffers, one for the Z-read/write command and one for the Z-read/ 
write command length. If this bit is "0", it indicates an ordinary read or write. 

11-6 These bits indicate the read/write subfunction or the control command subfunc- 

tion, depending on the type of call. 

For read and write calls (including Z-read and Z-write calls; a "1" or "2" as the 
first parameter of the call indicates a read or a write, respectively), there is one 
subfunction. This subfunction has an octal value of (zero), and indicates a nor- 
mal read or write operation. 

For control call requests (identified by a "3" as the first parameter of the call), sub- 
function bits 11 through 6 indicate a control command. The SCSI driver supports 
the following control requests: 



Octal Value Definition 

OB Rewind 



IB 
2B 



JXCW111U 

Write "n" File Mark(s) 

zu Backward space "n" record(s) 

3B Forward space "n" record(s) 

4B Rewind 

5B Rewind and go off line (unload tape) 

6B Dynamic Status Request 

7B Write Y Set Mark(s) 

10B Backward space "n" Set Mark(s) 

11B Forward space "n" Set Mark(s) 

13B Forward space "n" file(s) 

14B Backward space "n" file(s) 

where "n" is a positive integer from 1 (one) to 255, inclusive. 

The section titled "Control Commands" in this chapter describes each of these 
commands in detail. 
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5 to These bits represent the Logical Unit (LU) Number. Normally, the LU number 

can be any number from (zero) to 63, inclusive. However, if you use an XLUEX 
call instead of a normal EXEC call, you can use LU designations from to 255, 
inclusive. For information about XLUEX calls, refer to the RTE-A Programmer's 
Reference Manual, part number 92077-90007. 

The BUFR parameter indicates the user buffer address to read or write. 1 riis parameter is valid 
only for read and write calls (including Z-Buffer calls), not for control calls. The buffer address 
can be any legal value, as enforced by the operating system, just like any other exec call buffer. 

The BUFLN parameter is the request length that specifies the number of words or bytes to be 
transferred. A positive value indicates that the number is the number of words. A negative value 
indicates that the number equals the number of bytes, except for the special case of -32768 
(100000B), which indicates 32,768 words. This parameter is valid only for read and write calls (in- 
cluding Z-Buffer calls), not for control calls. 

The COMMAND parameter specifies the Command Descriptor Block (CDB), and is used only in 
Z-read and Z-write calls. This parameter contains the SCSI command you want to send to the 
device (for a description of Hewlett-Packard SCSI commands, refer to the HP35451A OEM Prod- 
uct Manual, part number C 1500-90950). The device driver and interface driver do not modify the 
command buffer. It is your responsibility to ensure that the format of the command request is 
correct. If the command request format is not correct, an error message appears. 

A Z-write call sends the specified command along with the data in the user buffer. A Z-read 
sends the specified command, then reads the response from the device. 

The COMMANDLN parameter specifies the length of the Command Descriptor Block sent with 
Z-Buffer calls in bytes or words. This parameter is used only in Z-read and Z-write calls. The 
parameter's value equals the number of words in the command. 

PARM1 is an optional parameter used only in Control requests (not in read or write requests). 
This parameter contains data specific to a particular control command. The parameters you can 
specify with each control command are described with the control commands. 

Control Commands 

You specify the control commands described in this section as the second parameter of a control 
request. The subfunction bits in the control word (see the section titled "DDQ24 Driver Read, 
Write and Control Calling Sequences" in this chapter) identify the control commands. All control 
requests have the same format: 

call exec(3,cntwd,[parml]) 

where 3 indicates that the call is a control call (not a read or write call), and cntwd is the control 
command (see subfunction bits 11 through 6 in the Control Word Bits description in this chap- 
ter). The parameter [parmlj is an optional parameter. Some control commands do not have any 
parameters. 
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The following paragraphs describe each control command in detail. 

Control OB Rewind 
Control 4B Rewind 

These two commands are exactly the same. Both of these rewind commands rewind the tape 
drive, but leave the tape online and loaded. There are no parameters to use with these com- 
mands. 

The calls for control commands OB and 4B, respectively, are as follows: 

call Exec (3,000B + lu) No parameters 
call Exec (3,400B + lu) No parameters 

For example, if you want to rewind the tape on a device that has LU number 5, using the 4B Re- 
wind command, you execute the following call: 

call exec(3,405B) 

The "3" denotes that the call is a control command, and the "405B" is 400B (the octal control 
command designation) plus 5B (the LU number). 

Control 1 B Write File Mark 

This command writes one or more file marks to the tape at the current tape location. It has one 
optional parameter, which indicates the number of file marks to write at the particular location. 

The call for control command IB is: 

call Exec (3,100B + lu,[number_filemarks]) 

where the optional parameter [nwriberjilemarks] is a positive integer that indicates the number of 
file marks to write at the current tape location. If you do not use this parameter, the default num- 
ber of file marks is one (1). If you enter zero in this field, the driver converts it to a one. 

For example, if you want to write three file marks to identify the current location on a tape on LU 
20B, you execute the following call: 

call exec(3,120B,3) 

The first "3" denotes that the call is a control command, the "120B" is 100B (the octal control 
command designation) plus 20B (the LU number), and the second "3" specifies three file marks. 

You may wish to write more than one file mark at a location in order to discriminate between dif- 
ferent marked locations on the tape. 

Note that this command sets the end of file bit (bit 7 in DVT 6), to write the file mark. For more 
information on this, see the section titled "Status" in this chapter. 
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Control 2B Backward Space Record 

This command rewinds the tape one or more records from the current tape location. It has one 
optional parameter to specify the number of records to rebind. 

The call for control command 2B is: 

call exec(3,200B + lu,[num_records]) 

where the optional parameter [num_records] is a positive integer that indicates the number of re- 
cords to rewind. If you do not use this parameter, the default number of records to rewind is one 
(1). If you enter zero in this field, the driver converts it to a one. 

For example, if you want to rewind six records from the current location on a tape on LU 7B, you 
execute the following call: 

call exec(3,207B,6) 

where "3" denotes that the call is a control command, "207B" is 200B (the octal control command 
designation) plus 7B (the LU number), and "6" is the number of records to rewind. 

Control 3B Forward Space Record 

This command forwards the tape one or more records from the current tape location. It has one 
optional parameter to specify the number of records to forward. 

The call for control command 3B is: 

call exec(3,300B + lu,[num_records]) 

where the optional parameter [numjrecords] is a positive integer that indicates the number of re- 
cords to forward. If you do not use this parameter, the default number of records to forward is 
one (1). If you enter zero in this field, the driver converts it to a one. 

For example, if you want to go forward nine records from the current location on a tape on LU 
3B, you execute the following call: 

call exec(3,303B,9) 

where "3" denotes that the call is a control command, "303B" is 300B (the octal control command 
designation) plus 3B (the LU number), and "9" is the number of records to forward. 
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Control 5B Rewind & Unload Tape 

This command rewinds the tape drive and unloads the tape. There are no parameters to use with 
this command. 

The call for control command 5B is as follows: 

call Exec (3,500B + lu) No parameters 

For example, if you want to rewind and unload the tape on a device that has LU number 6, you 
execute the following call: 

call exec(3,506B) 

The "3" denotes that the call is a control command, and the "506B" is 500B (the octal control 
command designation) plus 6B (the LU number). 

Control 6B Dynamic Status 

This command returns the status of the specified LU, extended transaction status and error 
codes. Status is returned in DVT 6 and DVT 16 through DVT 19 (refer to the section titled "Sta- 
tus" in this chapter for more information). 

The calls for control command 6B are as follows: 

call exec(3,600B -I- lu) 
call abreg(a,b) 
call rmpar(parms) 

The first call is the command call, which specifies the command and LU. The second call is to 
get the A and B Registers, and the third call is to get the RAM parameters. 

For detailed information about the A and B Registers and the RMPAR command and its parame- 
ters, refer to the RTE-A Programmer's Reference Manual, part number 92077-90007. 

Control 7B Write Set Mark 

This command writes one or more set marks to the tape at the current tape location. It has one 
optional parameter, which indicates the number of set marks to write at the particular location. 

The call for control command 7B is: 

call Exec (3,700B + lu,[number_setmarks]) 

where the optional parameter [numberjsetmarks] is a positive integer that indicates the number of 
set marks to write at the current tape location. If you do not use this parameter, the default num- 
ber of set marks is one (1). If you enter zero in this field, the driver converts it to a one. 
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For example, if you want to write two set marks to identify the current location on a tape on LU 
5B, you execute the following call: 

call exec(3,705B,2) 

The first "3" denotes that the call is a control command, the "705B" is 700B (the octal control 
command designation) plus 5B (the LU number), and the "2" specifies three set marks. 

You may wish to write more than one set mark at a location in order to discriminate between dif- 
ferent marked locations on the tape. 

Note that this command sets the end of file bit (bit 7 in DVT 6), to write the set mark. For more 
information on this, see the section titled "Status" in this chapter. 

Control 10B Backward Space Set Mark 

This command rewinds the tape one or more set marks from the current tape location. It has one 
optional parameter to specify the number of set marks to rewind. 

The call for control command 10B is: 

call exec(3,1000B + lu,[num_setmarks]) 

where the optional parameter [numjsetmarks] is a positive integer that indicates the number of 
set marks to rewind. If you do not use this parameter, the default number of set marks to rewind 
is one (1). If you enter zero in this field, the driver converts it to a one. 

For example, if you want to rewind two set marks from the current location on a tape on LU 3B, 
you execute the following call: 

call exec(3,1003B,2) 

where "3" denotes that the call is a control command, "1003B" is 1000B (the octal control com- 
mand designation) plus 3B (the LU number), and "2" is the number of set marks to rewind. 

Control 1 1 B Forward Space Set Marks 

This command forwards the tape one or more set marks from the current tape location. It has 
one optional parameter to specify the number of set marks to forward. 

The call for control command 11B is: 

call exec(3,1100B + lu,[num_setmarks]) 

where the optional parameter [numjsetmarks] is a positive integer that indicates the number of 
set marks to forward. If you do not use this parameter, the default number of set marks to for- 
ward is one (1). If you enter zero in this field, the driver converts it to a one. 

For example, if you want to go forward four set marks from the current location on a tape on LU 
6B, you execute the following call: 
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call exec(3,1106B,4) 

where "3" denotes that the call is a control command, "1106B" is 1100B (the octal control com- 
mand designation) plus 6B (the LU number), and "4" is the number of set marks to forward. 

Control 13B Forward Space File 

This command forwards the tape one or more files from the current tape location. It has one op- 
tional parameter to specify the number of files to forward. 

The call for control command 13B is: 

call exec(3,1300B + lu,[num__files]) 

where the optional parameter [numJUes] is a positive integer that indicates the number of files to 
forward. If you do not use this parameter, the default number of files to forward is one (1). If 
you enter zero in this field, the driver converts it to a one. 

For example, if you want to go forward eight files from the current location on a tape on LU 9B, 
you execute the following call: 

call exec(3,1309B,8) 

where "3" denotes that the call is a control command, "1309B" is BOOB (the octal control com- 
mand designation) plus 9B (the LU number), and "8" is the number of files to forward. 

Control 1 4B Backward Space File 

This command rewinds the tape one or more files from the current tape location. It has one op- 
tional parameter to specify the number of files to rewind. 

The call for control command 14B is: 

call exec(3,1400B + lu,[num_files]) 

where the optional parameter [numJUes] is a positive integer that indicates the number of files to 
rewind. If you do not use this parameter, the default number of files to rewind is one (1). If you 
enter zero in this field, the driver converts it to a one. 

For example, if you want to rewind six files from the current location on a tape on LU 7B, you 
execute the following call: 

call exec(3,1407B,6) 

where "3" denotes that the call is a control command, "1407B" is 1400B (the octal control com- 
mand designation) plus 7B (the LU number), and "6" is the number of files to rewind. 
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Status 

DVT (Device Table) word 6 and DVT words 16 through 19 contain various; types of status: 



DVT word 6 returns the LU status. 

DVT word 16 returns DDQ24 driver errors. 

DVT word 17 returns the length of the transferred data (the transmission log). 

DVT word 18 returns extended transaction status. 

DVT word 19 returns both sense code and additional sense code. 



For more detailed information about status and status calls, refer to the RTE-A Programmer's 
Reference Manual, part number 92077-90007. 



Logical Unit Status (DVT Word 6) 

DVT word 6 contains the LU's status. LU status is returned in the A-Register after any request 
call, or when a Status request asks for it. The DVT word 6 bits have the following functions: 



DVT word 6 Bits: 


15 14 13 12 11 10 9 
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7 6 
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Device type = 24B 


EOF 


DB 
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BOT 




WP 
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15 to 14 AV These two bits determine the availability of the tape device. 

= Driver is free to process a new request 

1 = Driver or user has set down the device 

2 - Driver currently processing I/O request 

3 = Device is down, but busy with a request (this normally occurs only when you 

down an active device). 

13 to 8 These bits set the device type. During system generation, this is set to 24B. 

7 EOF This is the end of file bit, which the driver sets when a request causes it to sense 

an EOF mark. 

6 DB DB stands for device busy. If set, it indicates that the device is performing a func- 

tion that prevents other operations from beginning (for example, a tape rewind). 

5 EOT EOT stands for end of tape. The driver sets this bit when the drive senses that the 

tape is positioned beyond the EOT mark. 

4 BOT BOT stands for beginning of tape. The driver sets this bit when the tape is posi- 

tioned at the BOT mark. 
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2 WP If set, this bit indicates that the tape is write protected. 

1 OF If set, this bit indicates that the drive is off line. 

E This bit is an error indicator. The system sets this bit if there is an error code in 

DVT word 16. 



Driver Error (DVT Word 16) 

DVT word 16 bits 5 through (zero) contain error codes for the DDQ24 device driver. The error 
codes are as follows: 

Dec. Octal Error and Solution 

OB = Normal request completion. 

1 IB = Illegal request. Check the syntax of your EXEC re- 

quest call. The EXEC call could have illegal param- 
eters or specify an unused LU or an unimplemented 
command. Retry the request after you check it. 

2 2B = Device not ready. The drive is offline, but media is 

present in the drive. If this occurs, first try unload 

ing, then reloading the tape. Second, send a SCSI 

Command Descriptor Block (CDB) to load the tape. 

If this does not work, make sure that the device is correctly 

connected, not busy, and correctly generated into the system. 

3 3B = Device timeout. Use the TO command to increase 

the timeout period. 

6 6B = Device write protected. Remove the tape's write 

protection. 

7 7B = Address error. Ensure that the SCSI address is cor- 

rect. 
10 12B = Tape fault. Check the tape for any problems. 
12 14B = Insufficient driver table space generated. Generate 

more driver table space. 

21 25B = Medium is not present. Insert the medium into the 

drive. 

22 26B = Incompatible cartridge. Use the correct type of tape 

cartridge. 

23 27B = Positioning error detected. First try ejecting, then 

reloading the tape. If this does not solve the error, 
a hardware error is indicated. 

24 30B = Hardware error. Check all connections, make sure 

that tape drive is functioning correctly. 

25 31B = Unknown error. This message should not appear. If it does, 

decode the error by checking DVT 19, which contains specific 
SCSI error codes. 
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Dec, 


Omi 


26 


32B = 


27 


33B = 



Error and Solution 

End of Data. 

Drive is offline or tape is unloading. Check the tape 
device. 
63 77B = Driver retry request. This message can appear only 
if the Control Word user error bit (UE bit 13) is set. 
Control Word bit 13 enables the user to interpret 
errors and take action on them, instead of allowing 
the system to handle errors. If you receive this mes- 
sage, check your request's syntax and try the request 
again. 

All codes of 28 decimal (34B octal) or higher are interface driver error codes, except for 63 (77B), 
which indicates a driver retry request. 

DVT Word 17 

DVT word 17 contains the transmission log, which is the length of the data transferred. 

Extended Transaction Status (DVT Word 18) 

DVT word 18 contains the extended transaction status of device driver DDQ24. The SCSI device 
reports these errors, which are converted to an error code. The error codes have the following 
meanings: 

= No error. 

1 = SCSI error. Check the sense code and additional sense code to identify the specific error. 

2 = Selection/reselection timeout. Check to ensure that the device address is correct. 

3 = Data Error. This indicates a hardware error. 

4 = Bus parity error. This indicates a hardware error. 

5 = Reset 

6 = Illegal bus free. This indicates a hardware error. 

7 = Abort request. The driver has sent an abort request. 

8 = Illegal request. This indicates an illegal script type. 

9 = Firmware error. 

Sense Code and Additional Sense Code (DVT Word 19) 

DVT word 19 contains the sense code and additional sense code. Appendix A in this manual de- 
scribes DVT word 19 and gives an example program to access it. The sense code is returned in 
the first byte (bits through 7) and the additional sense code is returned in the second byte (bits 
8 through 15). 
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DDQ24 Driver Communication Word (DVT Word 20) 



DDQ24 Driver Communication Word (DVT Word 20) 
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5 4 3 2 1 





DVT 20 


I 


X 


S 


X 


X 


1 


R 


R 


D 


P 


DVT priority 



I = Initial flag. This bit is set by the generator, then cleared on the first entry to the driver.. 
D = Delay. This bit is set if the driver is delaying and the next timeout is expected. 
R = Retry. This is the retry counter. It counts up to three retries if the device is busy. 
P = Powerfail Retry. During a power fail, a protocol failure may occur. This bit is during 

the second attempt at the I/O request. 
S = Serial bit. This bit is set to 1 (one) to indicate that this is a Serial device, not a block 

device. 



Disk Device Driver DDQ30 

The following sections describe disk device driver DDQ30, including Read/Write request calls 
and Z buffer calls. 



DDQ30 Read and Write Calls 

The calling sequences for the DDQ30 read and write requests are as follows: 

Read request: CALLEXEC(l,CNTWD,BUFR,BUFLN,TRACK,SECTOR) 
Write request: CALLEXEC(2,CNTWD,BUFR,BUFLN,TRACK,SECTOR) 

The following paragraphs define the read and write call parameters: 
BUFR: Buffer address, any legal value as enforced by the operating system. 



Control Word Bits: 


15 14 13 12 


11 


10 9 8 7 


6 


5 


4 3 2 1 





BB 


NB 


UE 


Z 


SubFunction 


Logical Unit Number 



Comments on bit groups: 
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15 BB Driver bypass bit to allow the interface driver to be called directly. We strongly 

recommend that you do not do this unless you are very sure that you know what 
you are doing. The DDQ30 driver translates the track and sector addresses into 
block addresses before sending those addresses to the interface driver IDQ35. This 
is necessary because the SCSI standard uses block addresses, not track and sector 
addresses. In addition, DDQ30 adds an address offset that corresponds with the 
logical disk address offset. If you bypass DDQ30 and communicate directly with 
the interface driver, the track and sector to block address translation does not 
occur. Also, the address offset is not added. In other words., you would be talking 
to the disk in "raw" (bit by bit) mode. Again, we recommend that you do not 
bypass DDQ30 to talk directly to the interface driver. 

14 NB No buffer bit to inhibit output buffering. No effect on driver. 

13 UE User error handling. No effect on driver. 

12 Z Dual buffer bit. = normal read or write; For Z bit = 1 see the section titled "Z 

Buffer Calls" in this chapter. 

11 to 6 Subfunction ~ Read or Write subfunction. 

The SCSI driver supports the following subfunctions on read and write calls: 

Octal Value Definition 

Normal read/write 

1..37 Rejected (Illegal subfunction) 

40 Issue request without timeout 

41..76 Rejected (Illegal subfunction) 

77 Normal read/write 

5 to Logical Unit Number. Used by RTE to translate to a Device Table (DVT); not 

passed to the driver. 

BUFLN: The request length specifying the number of words or bytes to be transferred. Positive 
values indicate the number of words and negative values indicate the number of bytes, except for 
the special case of -32768 (100000b), which indicates 32768 words. HP recommends that you use 
values that are a multiple of 128 words (256 bytes), because the disk driver always writes a com- 
plete block of 128 words. If you request a lesser value, the rest of the sector is written with what- 
ever data that happens to follow the requested buffer. 

TRACK- The track address where the data is stored. The range of values acceptable to the driver 
is 0..65535, limited by the size of the disk for which the call is intended. 

SECTOR: The sector address where the data is stored. For backward compatibility, sectors are 
defined as 64 words each, even though the driver works with blocks 128 words long. The driver 
rejects calls that start on an odd sector boundary. The range of values acceptable to the driver 
is even numbers from through 254 inclusive, limited by the size of the disk for which the call 
is intended. 

Note that this is larger than the 7-bit field currently supported by the FMP routines. 



5-1 4 Programming Reference Material 



The length of the request plus the starting address as given by the track and sector values must 
remain within the defined size of the disk. With the given limits, the maximum disk size is 
(2**16)*(2**8)*(2**7) = 2**31 bytes = 2.146 gigabytes. 

Z Buffer Calls 

The Z buffer is used to construct bus transactions that are outside the range of the usual read 
and write transfers, such as disk formatting requests. 

When the Z bit (bit 12) is set, the form of the EXEC call changes to: 

Read request: CALL EXEC(1,CNTWD,BUFR,BUFLN,ZBUF,ZLEN) 
Write request: CALL EXEC(2,CNTWD,BUFR,BUFLN,ZBUF,ZLEN) 

The ZBUF and ZLEN parameters describe a user Z buffer. The driver places no restrictions on 
the content of the Z buffer or the data buffer. The concept of track and sector does not apply to 
these calls. 
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Driver Parameter Table usage in DDQ30 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 


DVP01 


Reserved, set to 


SCSI Addr 


DVP02 


Reserved, set to 


Unit No. 


Reserved, set to 


DVP03 


Reserved, set to 


DVP04 


High Order word of starting block number 


DPV05 


Low order word of starting block number 


DVP06 


Number of Tracks on LU 


DVP07 


Reserved, set to 


# of RTE blocks/tracks 


DVP08 


S 


E 


Reserved 


BF 



S = 1 if driver should manage spin-up and spin-down 
E = 1 eject disk on last dismount 

BF = Blocking factor minus 1: 

= 256 bytes/sector 

1 = 512 bytes/sector 

2 = 768 bytes/sector 

3 = 1024 bytes/sector 
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DDQ30 Driver Communication Word (DVT Word 20) 



DDQ30 Driver Communication Word (DVT Word 20) 


15 14 13 12 11 10 9 8 7 6 


5 4 3 2 1 





DVT 20 


I 


L 





M 


S 


1 


R 


R 


D 


P 


DVT priority 



I = Initial Flag 

L = Locked 

M = Mount 

S = Spinning 

R = Retry Counter 

D = Delay 

P = Powerfail Retry 



Set by generator, cleared on first entry to driver. 

Eject button has been disabled. 

Set if disk has been mounted. 

Set if disk is spinning. 

Counts up to three retries if the disk is busy. 

Set if driver is delaying, next timeout is expected. 

During powerfail, a protocol failure may occur. This bit is set 

during the second attempt at an I/O request. 



Interface Driver IDQ35 

Users should not call the SCSI interface driver directly. By the time the device driver calls the in- 
terface driver, the device driver has transformed the DVT to the following format for normal read 
and write requests (Z buffer requests are passed through unchanged): 



Device Driver DVT Transformation 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 


DVT 15 


Type 


UE 


Z 


Subfunction 


X X 


L 


UD 


Req* 


DVT 16 





Request buffer address 


DVT 17 


Request length 


DVT 18 


High order word of block address for the transfer 


DVT 19 


Low order word of block address for the transfer 


DVT 20 


I 


? 


S 


? 


? 


1 


? 


? 


? 


? 


? 



* Request Code 

? = Driver dependent bit. This bit depends on the device driver (see the descriptions of DVT 
word 20 for each of the device drivers in this Chapter to obtain more information). 



I = Initial Flag 
S = Serial Bit 



Set by generator, cleared on first entry to driver. 

If set ( = 1), this bit indicates that the device? is a Serial device. If 

this bit is not set ( = 0), the device is a block device. 



Bit 10 of DVT 20 is set to 1 on all calls to the SCSI bus. This bit is for calls from DDC00. 



5-16 Programming Reference Material 



Next, the interface driver performs the requested I/O to the interface card. At the completion of 
the request, the status is stored in the DVT in the following format: 



DVT STATUS: 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 


DVT 6 


AV 


Driver type = 30B 


Driver status 


DVT 15 


Type 


UE 


Z 


Subfunction 


X X 


L 


UD 


Req* 


DVT 16 


Error code 


DVT 17 


Transmission log 


DVT 18 


Extended status #1 Transaction status 


DVT 19 


Extended status #2 SCSI status 


DVT 20 


I 


? 


S 


? 


? 


1 


? 


? 


? 


? 


? 



* Request Code 

? = Driver dependent bit. This bit depends on the device driver (see the descriptions of DVT 
word 20 for each of the device drivers in this Chapter to obtain more information). 



I = Initial Flag 
S = Serial Bit 



Set by generator, cleared on first entry to driver. 

If set ( = 1), this bit indicates that the device is a Serial device. If 

this bit is not set ( = 0), the device is a block device. 
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A 



Error Messages 



Errors can come from the rewritable disk drive, the interface driver or the device drivers. This 
appendix lists the possible error messages by place of origin to help you find the message and 
what to do about it. The first part of the appendix covers error messages from the device drivers. 
The second part describes interface driver errors and the last part describes device-specific 
errors. 



Tape Device Driver (DDQ24) Errors 



Driver Error (DVT Word 16) 

DVT word 16 bits 5 through (zero) contain error codes for the DDQ24 device driver. The error 
codes are as follows: 

Dec. Octal Error and Solution 

OB = Normal request completion. 

1 IB = Illegal request. Check the syntax of your EXEC re- 

quest call. The EXEC call could have illegal param- 
eters or specify an unused LU or an unimplemented 
command. Retry the request after you check it. 

2 2B = Device not ready. The drive is offline, but media is 

present in the drive. If this occurs, first try unload 
ing, then reloading the tape. Second, send a SCSI 
Command Descriptor Block (CDB) to load the tape. If this does 
not work, make sure that the device is correctly connected, not 
busy, and correctly generated into the system. 

3 3B = Device timeout. Use the TO command to increase 

the timeout period. 

6 6B = Device write protected. Remove the tape's write 

protection. 

7 7B = Address error. Ensure that the SCSI address is correct. 
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Dec Octal Error and Solution 

10 12B = Tape fault. Check the tape for any problems. 
12 14B = Insufficient driver table space generated. Generate 
more driver table space. 

21 25B = Medium is not present. Insert the medium into the 

drive. 

22 26B = Incompatible cartridge. Use the correct type of tape 

cartridge. 

23 27B = Positioning error detected. First try ejecting, then 

reloading the tape. If this does not solve the error, 
a hardware error is indicated. 

24 30B = Hardware error. Check all connections, make sure 

that tape drive is functioning correctly. 

25 31B = Unknown error. This message should not appear. 

If it does, decode the error by checking DVT 19, 
which contains specific SCSI error codes. 

26 32B = End of Data. 

27 33B = Drive is offline or tape is unloading. Check the tape 

device. 
63 77B = Driver retry request. This message can appear only 
if the Control Word user error bit (UE bit 13) is set. 
Control Word bit 13 enables the user to interpret 
errors and take action on them, instead of allowing 
the system to handle errors. If you receive this mes- 
sage, check your request's syntax and try the request 
again. 

All codes of 28 decimal (34B octal) or higher are interface driver error codes, except for 63 (77B), 
which indicates a driver retry request. 

DVT Word 17 

DVT word 17 contains the transmission log, which is the length of the data transferred. 

Extended Transaction Status (DVT Word 18) 

DVT word 18 contains the extended transaction status of device driver DDQ24. The SCSI device 
reports these errors, which are converted to an error code. The error codes have the following 
meanings: 

= No error. 

1 = SCSI error. Check the sense code and additional sense code to identify the specific error. 

2 = Selection/reselection timeout. Check to ensure that the device address is correct. 

3 = Data Error. This indicates a hardware error. 

4 = Bus parity error. This indicates a hardware error. 

5 = Reset. 

6 = Illegal bus free. This indicates a hardware error. 

7 = Abort request. The driver has sent an abort request. 
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8 = Illegal reqest. This indicates an illegal script type. 

9 = Firmware error. 



Disk Device Driver (DDQ30) Errors 

The device driver generates the following errors, which are returned in bits 5 through of $DVT 
16. All error number values are decimal numbers. 

Error: 1, illegal request. A track or sector address error has occurred. 

Error: 2, device not ready. The device is not mounted. Mount the device and try again. 

Error: 3, device timeout. 

Error: 5, transmission error. Check extended status. 

Error: 6, device write protect. Either remove the write protect from the current 
device or write to a different device. 

Error: 7, address error. Check the address on the device and compare it to the 
generation record's address. 

Error: 10, disk fault. Format the disk. 

Error: 12, insufficient driver table space generated. Regenerate the system. 

Error: 21, no disk in drive. 

Error: 22, incompatible cartridge. Change cartridges. 

Error: 23, medium uninitialized or format corrupted. Format the disk. 

Error: 24, no spares available. Replace the disk. 

Error: 25, automatic reallocation failed. 

Error: 26, defect list update failed. This is not implemented with our format. 

Error: 27, defect list not available. This is not implemented with our format. 

Error: 29, illegal logical block address. 

Error: 62, device busy. 
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Interface Driver (IDQ35) Errors 



The error descriptions in this section list the error number and the type of error, then provide a 
description of the error and a solution to the error. All error number values are decimal num- 
bers. Interface driver IDQ35 can produce the following errors: 

Error: 1, driver rejected call. This error indicates illegal subfunction bits. 
Solution: Check your user program and make sure that the EXEC call is correct. 

Error: 12, generation error. This error indicates that the number of IFr extension 
words was not sufficient. 

Solution: Correct the answer file so that the interface table contains the c orrect number 
of extension words (see Chapter Three under the heading "Create A New 
Answer File"), then regenerate the system. 

Error: 28, driver defined error. This indicates a protocol failure. The SCSI Card 
returned a response that the driver was not expecting. 

Solution: Reboot the system. If the problem persists, there may be a SCSI Card 
hardware failure. 

Error: 40, driver defined error. This error message can occur for three reasons. Either 
the TERMPWR switch is not enabled, the SCSI Card fuse is open, or the SCSI 
cable is not attached. 

Solution: Check the TERMPWR switch to ensure that TERMPWR is enabled (switch 2 
on switch SW1 should be closed to enable TERMPWR; see Chapter Two under 
the heading "Setting Switch SW1" for a detailed description of this switch). 
Make sure that the SCSI cable is firmly seated. Check the SCSI Card fuse (see 
Figure 2-2 in Chapter Two for a diagram of the card layout); if the fuse is 
open, replace it with the spare fuse provided with the SCSI product. 

Error: 41, driver defined error. This message indicates that the first caM to the SCSI 
Card went directly to the interface driver (IDQ35), bypassing the device driver 
(DDQ30). This is not allowed, because the device driver's LU setup must be 
done before the first call to the interface driver. 

Solution: Reboot the system. Do not bypass the device driver until after the first normal 
call. 

Error: 42, driver defined error. The SCSI Card address is the same as the SCSI device 
address. 

Solution: The addresses of the SCSI Card and its devices must be unique. Define 
different addresses for the SCSI Card and each device. 
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Error: 43, driver defined error. The SCSI address is incorrect, or no device on the 
SCSI bus responded to the SCSI address received from DVP (Driver 
Parameter) 1. 

Solution: Make sure that all devices are connected and turned on. Check all address 

switches on the devices. Check the answer file for correct DVT (Driver Table) 
entry for driver parameter one. 

Error: 44, driver defined error. Incorrect length for CDB (Command Descriptor 
Block) in Zbuffer call or illegal CDB type (per SCSI-II standard). 

Solution: Check the user program and make sure that the Z-buffer format is correct. 

Error: 45, driver defined error. The revision level of the interface driver and the SCSI 
Card firmware are incompatible with each other. This means that either the 
interface driver was changed to a revision incompatible with the SCSI Card 
firmware, or the SCSI Card firmware was changed to a revision incompatible 
with the interface driver. 

Solution: Ensure that the interface driver and SCSI Card firmware revisions are 
compatible with each other. 



Optical Disk Drive Errors 



The Optical Disk Drive generates two types of extended status error messages. The first type, 
sense key, provides general error information. The second type, additional sense code, provides 
more detailed information about the error. Both of these codes are contained in DVT word 19. 

You can get these messages by calling RMPAR as described in the RTE-A Programmer's Refer- 
ence Manual, part number 92077-90007. 

The following program segment is an example of a RMPAR call in FORTRAN to retrieve the 
extended status: 



Integer*2 



Ext endedS tatus (0:4) 



CALL EXEC ( 1 , DISKLU , DBUF , DLEN , TRACK, SECTOR) 
CALL ABREG ( STATUS, TLOG) 
CALL RMPAR (EXTENDEDSTATUS) 

The format of extended status (3) in DVT 19 is as follows: 



Additional Sense Code 


Sense Key 



15 



8 7 
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Sense Keys 

The sense key error messages provide general error information. They are contained in the lower 
byte (0-7) of DVT word 19. All error number values are decimal numbers. 

NO SENSE. This indicates that there is no specific sense key information to report for the 
designated logical unit. The sense key is returned when the command completed success- 
fully. 

1 RECOVERED ERROR. This shows that the last command completed successfully with 
some recovery action performed by the target. 

2 NOT READY. This indicates that the logical unit cannot be accessed. Check if the LU is 
correctly connected, and that the power is on. 

3 MEDIUM ERROR. The command terminated with an unrecovered error condition caused 
by a medium defect. Check to see if the disk has been formatted or try another disk. 

4 HARDWARE ERROR. The controller detected a hardware error. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 

5 ILLEGAL REQUEST. The command descriptor block or the additional command parame- 
ters (supplied as data for some commands) contained an illegal parameter. Check the EXEC 
call to make sure that the parameters are correct. 

6 UNIT ATTENTION. The medium has been loaded, the unit has been reset, or the Mode 
Select parameters have been changed. Retry the request. If several retries fail, a possible 
problem with the 650/A Magneto Optical Drive is indicated. 

7 DATA PROTECT. The Write Protect condition of the medium cartridge switch cannot per- 
form a command to write the medium (that is, the medium is write protected). Write to a 
medium that is not write protected. 

10 COPY ABORTED. An error condition on the source device, the destination device, or both, 
caused a COPY or a COPY AND VERIFY command to abort. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 

Additional Sense Code 

The additional sense code error messages provide detailed error information. They are contained 
in the higher byte (bits 8 through 15) of DVT word 19. All error number values are decimal num- 
bers. 

No Additional Sense Information (NO SENSE). 
There is no error to report. 

2 No ESDI Command Complete (HARDWARE ERROR). 

The drive unit did not return the ESDI command complete. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 
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3 Write Fault (HARDWARE ERROR). 

The write command failed. The logical block address where the fault was detected may be 
returned in the Logical Block Address field or information Byte field of the sense data. Make 
sure that the media you are trying to write is not write protected. 

4 Drive Not Ready (NOT READY). 

The READY signal of ESDI was negated. Make sure that the medium is fully inserted in the 
drive, that the drive unit spins up and that the focus or slide servo is unlocked. 

5 Drive Not Selected (NOT READY). 

The drive unit is not selected. This indicates a possible problem with the 650/A Magneto 
Optical Drive. 

7 Multiple Drives Selected (HARDWARE ERROR). 

More than one drive responded for the same drive number. This indicates a possible prob- 
lem with the 650/A Magneto Optical Drive. 

8 Logical Unit Communication Failure (HARDWARE ERROR). 

An error was detected during the communication between the drive unit and the controller 
unit (for example, a parity error). This indicates a possible problem with the 650/A Magneto 
Optical Drive. 

9 Track Following Error (HARDWARE ERROR). 

Still-jump failed and the optical disk's head could not stay on the same track. This indicates 
a possible problem with the 650/A Magneto Optical Drive. 

10 No Disk (NOT READY). 

Medium not inserted into the drive unit. Make sure that there is a medium and that it is fully 
inserted into the drive. 

11 Load/Unload Failure (HARDWARE ERROR). 

A failure was detected during loading or unloading the cartridge. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 

12 Spindle Failure (HARDWARE ERROR). 

The spindle servo did not lock with the reference signal and the medium did not rotate cor- 
rectly. This indicates a possible problem with the 650/A Magneto Optical Drive. 

13 Focus Failure. (HARDWARE ERROR). 

The focus servo was missed. Issue a START/STOP UNIT command with its Start bit set to 
one (1) to restart the drive. If this fails, a possible problem with the 650/A Magneto Optical 
Drive is indicated. 
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14 Tracking Failure. (HARDWARE ERROR). 

Tracking servo could not be locked. This indicates a possible problem with the 650/A 
Magneto Optical Drive. 

15 Drive Initialization Failure (HARDWARE ERROR). 

The drive's power on diagnostics failed. This indicates a possible problem with the 650/A 
Magneto Optical Drive. 

16 ID CRC Error (HARDWARE ERROR). 

The controller detected the error of ID cyclic check code transferred from the drive unit. 
This indicates a possible problem with the 650/A Magneto Optical Drive. 

17 Unrecovered Read Error Of Data Blocks (MEDIUM ERROR). 

The error correction code could not correct the data errors. The logical block address where 
the fault was detected may be returned in the Logical Block Address field or information 
Byte field of the sense data. To correct this error, replace the medium. If this error persists, 
a problem with the 650/A Magneto Optical Drive may exist. 

21 Seek Positioning Error (HARDWARE ERROR). 

The seek to the specified track failed after retrials. To correct this error, replace the medium. 
If this error persists, a problem with the 650/A Magneto Optical Drive may exist. 

24 Recovered Read Data With ECC Procedure (RECOVERED ERROR). 

There was an interleave that contained seven or eight byte errors. The error correction 
succeeded. This indicates a possible problem with the 650/A Magneto Optical Drive. 

32 Invalid Command Operation Code (ILLEGAL REQUEST). 

The specified command operation code is not implemented. This indicates a possible prob- 
lem with the 650/A Magneto Optical Drive. 

33 Illegal Logical Block Address (ILLEGAL REQUEST). 

The specified logical block address was outside the valid area. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 

35 Illegal Function For Medium Type (ILLEGAL REQUEST). 

The format parameter is invalid for the medium type. This indicates a possible problem with 
the 650/A Magneto Optical Drive. 
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36 Illegal Field In CDB (ILLEGAL REQUEST). 

The received Command Descriptor Block (CDB) contained an error. This Additional Sense 
Code is returned in the following situations: 

• Reserved field in CDB is not zero. 

• Invalid combination of parameters. For example, both the eject bit and the start bit are 
set in the START/STOP UNIT command. 

• Illegal parameter at that state. For example, a command using the relative address 
(ReLAdr) bit set to one (1) is issued after the command whose link bit is not set to one. 
This indicates a possible problem with the 650/A Magneto Optical Drive. 

37 Invalid LUN (ILLEGAL REQUEST). 

LUN 2 through 7 is specified or the specified LUN (0 or 1) does not respond to the selection 
from the controller unit. This indicates a possible problem with the 650/A Magneto Optical 
Drive. 

38 Invalid Field in Parameter list (ILLEGAL REQUEST). 

The received parameters contained an error. This indicates a possible problem with the 
650/A Magneto Optical Drive. 

39 Write Protected (DATA PROTECT). 

Erasing or writing was aborted because the write protect switch of the cartridge is on. Either 
switch the write protect on the cartridge off or change the media. 

40 Medium Changed (UNIT ATTENTION). 

The medium was loaded. The Additional Sense Code notifies the initiator that the medium 
has been changed since the execution of the last command. This code implies Mode Select 
Parameters changed (Additional Sense Code message 42). This indicates a possible problem 
with the 650/A Magneto Optical Drive. 

41 Power On or Reset or Bus Device Reset Occurred (UNIT ATTENTION). 

This message notifies the initiator that the reset condition has happened since the last com- 
mand. This code implies that Mode Select Parameters changed (Additional Sense Code 42). 
This indicates a possible problem with the 650/A Magneto Optical Drive. 

42 Mode Select Parameters Changed (UNIT ATTENTION). 

This message notifies the initiator that the mode select parameters have been changed 
since the execution of the last command. This indicates a possible problem with the 650/A 
Magneto Optical Drive. 

48 Incompatible Cartridge (MEDIUM ERROR). 

The cartridge's ID hole is invalid. Change the cartridge to correct this error. 

49 Medium Format Corrupted (MEDIUM ERROR). 

PEP, SFP or the format information sector in the CDA is invalid. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 
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50 No Defect Spare Location Available (MEDIUM ERROR). 

The number of defect sectors listed in the PDL and SDL (DTA) exceeded 1024, or the num- 
ber of defect sectors listed in the SDL exceeded the specified value calculated by the number 
of groups and spare blocks per group. This message means that the disk is defective and you 
should replace it. 

56 Recovered with Automatic Reallocation (RECOVERED ERROR). 

Automatic write reallocation executed successfully. This indicates a possible problem with 
the 650/A Magneto Optical Drive. 

57 Automatic Reallocation Failure (MEDIUM ERROR). 

Automatic write reallocation failed after retrying three times. This indicates a possible prob- 
lem with the 650/A Magneto Optical Drive. 

58 Defect List Update Failure (MEDIUM ERROR). 

Attempt to update the defect table failed after the successful sparing of the data sector. 
This indicates a possible problem with the 650/A Magneto Optical Drive. 

61 Defect List Not Available (MEDIUM ERROR or RECOVERED ERROR). 

Specified defect list is not available. This indicates a possible problem with the 650/A 
Magneto Optical Drive. 

66 Power On Diagnostic Failure (HARDWARE ERROR). 

Power on diagnostic failed. This indicates a possible problem with the 650/A Magneto 
Optical Drive. 

67 Message Reject Error (HARDWARE ERROR). 

The command was aborted because the initiator rejected the message from the SMO-C501 
by issuing a MESSAGE REJECT message. This indicates a possible problem with the 650/A 
Magneto Optical Drive. 

68 Internal Controller Error (HARDWARE ERROR). 

The controller detected an error related to the controller hardware or firmware. This indi- 
cates a possible problem with the 650/A Magneto Optical Drive. 

71 SCSI Interface Parity Error (HARDWARE ERROR). 

The command was aborted due to parity error of the SCSI bus. This indicates a possible 
problem with the 650/A Magneto Optical Drive. 

72 Initiator Detected Error (HARDWARE ERROR). 

The command was aborted because the initiator sent the INITIATOR DETECTED ERROR 
message. This indicates a possible problem with the 650/A Magneto Optical Drive. 
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Digital Audio Tape Drive Errors 



The DAT Drive generates two types of extended status error messages. The first type, sense key, 
provides general error information. The second type, additional sense code, provides more de- 
tailed information about the error. Both of these codes are contained in DVT word 19. 

You can get these messages by calling RMPAR as described in the RTE-A Programmer's Refer- 
ence Manual, part number 92077-90007. 

The following program segment is an example of a RMPAR call in FORTRAN to retrieve the 
extended status: 



Integer*2 



ExtendedStatus (0:4) 



CALL EXEC (l.DISKLU.DBUF.DLEN, TRACK, SECTOR) 
CALL ABREG( STATUS, TLOG) 
CALL RMPAR (EXTENDEDSTATUS) 

The format of extended status (3) in DVT 19 is as follows: 



Additional Sense Code 


Sense Key 



15 



8 7 



The error descriptions are split into three columns. The first column gives the Sense Key Code 
(bits -7 of DVT 19), the second column gives the Additional Sense Code (bits 8 - 15 of DVT 19), 
and the third column contains a description of the error. 



Sense 
Key 


Add. 
Sense 


Description 


OH 


00 

0A 
81 


NO SENSE 

This indicates that there is no specific sense key information to report for the 
designated logical unit. This normally indicates a successful command. This 
can also indicate the detection of a Filemark, an End-of-Partition/Media, a 
Save-Set Mark, a Beginning-of-Partition/Media, or an End-of-Data. These 
are not errors. 

Error-rate warning. 

Humidity Warning. 
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Sense 
Key 


Add. 
Sense 


Descrpition 


2H 


04 

3A 


DRIVE NOT READY 

This indicates that the drive is offline, but media is present in the drive. The 
drive returns this status for any commands that cause tape motion following an 
UNLOAD with the Immed bit set, or if the front panel REJECT button was 
pressed. The drive continues to return this status until the tape is physically 
ejected. The drive returns this status following a LOAD with the Immed bit set 
for any subsequent commands which would cause tape motion, until the tape is 
loaded. 

The drive contines to return this Sense information if the host previously ex- 
ecuted a PREVENT MEDIA REMOVAL command followed by an UN- 
LOAD. The host cannot perform any operation which would cause tape mo- 
tion, such as Write, Read, Verity and Space commands. The host may load the 
tape when the unit is offline. The host may also execute any diagnostic com- 
mands which do not access the tape. 

This message can also indicate that the drive is in the process of becoming 
ready; in other words, the tape is being loaded. 

Medium is not present. This is returned when in a quiescent state with no 
media in the drive, for all commands which would cause: tape motion. 


3H 


00 

oc 

11 

30 
3B 
50 


MEDIUM ERROR 

Drive has encountered the physical EOP/M. 

The drive has a write error where the RAW Retry Limit was exceeded. The 
non-recovered error condition was probably caused by a flaw in the tape or a 
dirty head. A hardware problem may cause this error, but it is most likely to be 
media-related. 

The drive had an unrecovered read error because of flaws in the meduim, 
which means that the sub-area was unreadable, or there were an excessive 
number of uncorrectable tracks. 

Incompatible Medium Installed or unknown format (audio) encountered. The 
drive cannot read or space along the tape because either a format violation was 
encountered or the format is unknown. 

Positioning Error Detected. The drive either lost position during a Read, Verify 
or Space operation, or was not positioned at BOT for a Write Lead-in-Area 
operation. 

The drive had an error when appending new data during a write-type opera- 
tion. It either could not find the end of the group, or could not write the new 
group successfully. 
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Sense 
Key 


Add. 
Sense 


Description 


4H 


03 
09 

44 

53 
82 


HARDWARE ERROR 

A hardware failure occurred during a Write operation. 

A track-following hardware error occurred, generated by the servo/mechan- 
ism. 

The drive returns this error for all unexpected internal error conditions. It in- 
dicates that the drive detected a non-recoverable hardware failure while per- 
forming the command. 

The Sub- Assembly Code field will identity which sub-assembly is causing the 
error. If this field is zero, the host should issue a SEND DIAGNOSTIC com- 
mand with the self-test bit set, to test the drive thoroughly and identify the 
failing component. 

It is also returned if the drive has a diagnostic failure. The SEND DIAGNOS- 
TIC command generates a CHECK CONDITION status with this sense data 
set if the drive fails the requested diagnostic test or sequence. The RECEIVE 
DIAGNOSTICS RESULTS command provides further information. 

Media Load/Eject failed. The drive has been unable to complete its load se- 
quence successfully. This may be due to mechanical problems, or because the 
drive could not successfully read and write from the test region of the tape. 

Moisture detected. 


5H 


1A 

20 

24 

25 
26 

39 


ILLEGAL REQUEST 

This indicates a parameter length error in the command descriptor block (the 
value requested does not fall on header, page or block descriptor boundaries), 
or that the Parameter list Length is too large for the specified command (the 
drive is not expecting so much data). 

Invalid command operation code. 

Invalid field in the command descriptor block. Either the field is not sup- 
ported, or a reserved field was used illegally. The Sense Key Specific Bytes 
should be checked, as the Field Pointer bytes will identify the illegal bit or 
field. 

Logical Unit not supported. The LUNTRN field in the Identify message was 
not set to either 80H or COH. 

This indicates an invalid test number, header or field in the Parameter list, or 
that the parameter page is not supported. The Sense Key Specific Bytes 
should be checked, as the Field Pointer bytes will identify the illegal bit or 
field. 

Invalid bits in the IDENTIFY message. The message was not set to either 
80H or COH 
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Sense 
Key 


Add. 
Sense 


Description 


6H 


28 
29 

2A 


UNIT ATTENTION 

Indicates that the tape may have been changed. 

The drive has had a reset, a Bus Device reset, or the drive failed its power- 
on self-test or diagnostics. 

The Mode or Log parameters may have changed. 


7H 


27 


WRTTE-PROTECTED 

Indicates that a command that writes to the tape was attempted on a 
write-protected cartridge. 


8H 


00 


BLANK CHECK 

Blank tape was encountered at BOT or EOD was encountered on a ready 
type of operation. 


AH 


00 
28 


COPY ABORTED 

Indicates that a COPY command was aborted due to an error condition on 
the source or the destination device. 

COPY cannot execute because the host cannot disconnect. 


BH 


00 

2C 
43 

45 
47 

48 
49 

4A 

4B 

4E 


ABORTED COMMAND 

Host aborted current command by sending an ABORT message. 

The Phase sequence during command execution was not as expected. 

The Message phase indicated by the communicating device was not as ex- 
pected by the drive. 

A SCSI Selection/Reselection error occurred. 

The drive detected a SCSI parity error and proceeded to the Status phase 
without completing execution of the command. 

The drive received an INITIATOR DETECTED ERROR message. 

The drive received an illegal message and proceeded to the Status phase 
without completing execution of the command. 

The Command phase indicated by the communicating device was not as ex- 
pected by the drive. 

The Data phase indicated by the communicating device was not as expected 
by the drive. A DMA error could cause this report. 

The host sent a new command to the drive while a previous command was 
executing. 


DH 


00 


VOLUME OVERFLOW — unused. 

The drive encountered the physical EOP/M on a Write Filemark command. 
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Single-Ended Cable Pin to Signal List 



Single-Ended Cable 



Figure B-l on the following page provides a pin to signal list for the single-ended (standard) 
cable. 

Notes for Figure B-l: 

1. Connector A = 80 pin Connector B = 50 pin 

2. TERMPWR pins provide 4.5 V at .5 amps for SCSI bus terminator power. This line is 
designed to drive the external bus terminator. It is not intended for general use. 



Terminator Power 

Figures B-l and C-l show the assignment of terminator power pins on the single-ended and 
differential cable connectors. Either the SCSI Card or a peripheral device can supply terminator 
power. If terminator power comes from the SCSI Card, it is not applied until the cable connector 
hood is properly connected. The SCSI cable has a built-in interlock that tells the SCSI Card to 
enable TERMPWR to the terminators when it is connected, unless TERMPWR comes from a 
device. For a description of how to enable and disable terminator power on the SCSI Card, see 
the description of switch SW1-2 in Chapter Two under the heading "Setting Switch SW1". 

SCSI Card TERMPWR is designed to supply the power to the termination network at each end 
of the cable. The termination network at the computer end is integrated onto the card. The power 
available to the user is greater than 4.5 volts at up to .5 amps. 



NOTE 

Only one device on the SCSI bus should supply TERMPWR. 
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Figure B-1. Single-Ended Cable Pin to Signal List 
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Differential Cable Pin to Signal List 



Differential Cable 

Figure C-l on the following page provides a pin to signal list for the differential cable (option 
001). 

Notes for figure C-l: 

1. TERMPWR pins provide 4.5 V at .5 amps for SCSI bus terminator power. 

2. Connector A = 80 pin Connector B = 50 pin 

CAUTION 

Make certain that the power is turned off when you connect the cables to the 
SCSI product and all peripherals, to prevent shorting the TERMPWR pins to 
the equipment. The TERMPWR pins cany live voltage. Failure to turn off the 
power will result in damage to the equipment. 



Terminator Power 

Figures B-l and C-l show the assignment of terminator power pins on the single-ended and 
differential cable connectors. Either the SCSI Card or a peripheral device can supply terminator 
power. If terminator power comes from the SCSI Card, it is not applied until the cable connector 
hood is properly connected. The SCSI cable has a built-in interlock that tells the SCSI Card to 
enable TERMPWR to the terminators when it is connected, unless TERMPWR comes from a 
device. For a description of how to enable and disable terminator power on the SCSI Card, see 
the description of switch SW1-2 in Chapter Two under the heading "Setting Switch SW1". 

SCSI Card TERMPWR is designed to supply the power to the termination network at each end 
of the cable. The termination network at the computer end is integrated onto the card. The power 
available to the user is greater than 4.5 volts at up to .5 amps. 



NOTE 

Only one device on the SCSI bus should supply TERMPWR. 
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Figure C-1. Differential Cable Pin to Signal List 
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Card Connector P3 Pin to Signal List 

Table D-l provides a pin to signal list for SCSI Card connector P3. 



Table D-1 . Connector P3 Pin to Signal List 



Pin 


Signal Name 


Pin 


Signal Name 


A1 


GNDSENSA 


B1 


GROUND 


A2 


DBSEO 


B2 


DBCOMO 


A3 


DBDFO 


B3 


GROUND 


A4 


DBSE1 


B4 


DBCOM1 


A5 


DBDF1 


B5 


GROUND 


A6 


DBSE2 


B6 


DBCOM2 


A7 


DBDF2 


B7 


GROUND 


A8 


DBSE3 


B8 


DBCOM3 


A9 


DBDF3 


B9 


GROUND 


A10 


DBSE4 


B10 


DBCOM4 


A11 


DBDF4 


B11 


GROUND 


A12 


DBSE5 


B12 


DBCOM5 


A13 


DBDF5 


B13 


GROUND 


A14 


DBSE6 


B14 


DBCOM6 


A15 


DBDF6 


B15 


GROUND 


A16 


DBSE7 


B16 


DBCOM7 


A17 


DBDF7 


B17 


GROUND 


A18 


DBSEP 


B18 


DBCOMP 


A19 


DBDFP 


B19 


GROUND 


A20 


DIFFSENS 


B20 


GROUND 


A21 


IOSE 


B21 


IOCOM 


A22 


IODF 


B22 


GROUND 


A23 


CDSE 


B23 


CDCOM 


A24 


CDDF 


B24 


GROUND 


A25 


MSGSE 


B25 


MSGCOM 


A26 


MSGDF 


B26 


GROUND 


A27 


REQSE 


B27 


REQCOM 


A28 


REQDF 


B28 


GROUND 


A29 


ATNSE 


B29 


ATNCOM 


A30 


ATNDF 


B30 


GROUND 


A31 


ACKSE 


B31 


ACKCOM 


A32 


ACKDF 


B32 


GROUND 


A33 


SELSE 


B33 


SELCOM 


A34 


SELDF 


B34 


GROUND 


A35 


BSYSE 


B35 


BSYCOM 


A36 


BSYDF 


B36 


GROUND 


A37 


RSTSE 


B37 


RSTCOM 


A38 


RSTDF 


B38 




A39 


- 


B39 


TERMPWR 


A40 


GNDSENSB 


B40 


TERMPWR 



The TERMPWR pins provide 4.5V at .5 amps for SCSI bus terminator power. 
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Additional sense code: This provides more specific or additional drive error information for 
sense code. Additional sense code is located in the high byte (bits 6 - 15) of DVT 19. 

Answer file: The file used to generate an RTE system that will match the general hardware and 
software configuration. 

Backlashes: The hardware component that connects the I/O cards, CPU and memory within the 
computer. 

Blocking Factor: A descriptor that indicates how to map RTE sectors into device sectors. 

Boot Command file: This file is used when first loading RTE, to customize the system to its par- 
ticular hardware and software configuration. 

BUFR: Buffer address. 

BUFLN: Buffer length. 

Checksum: A method of error detection used to verity the integrity of the internal PROM. 

Control Request: A command which enables users to make specific requests to the driver other 
than usual read and write requests. 

CNTWD: Control word. 

DDQ24: Relocatable SCSI tape device driver. 

DDQ30: Relocatable SCSI disk device driver. 

DDQ30_GEN: File that contains the default generation records for products supported by the 
DDQ30 disk device driver. 

DDQ30.MAC: File that contains the source code for the 650/A Rewritable Optical Disk Driver. 

DMA Priority: This determines the priority between two I/O cards attempting to use the back- 
plane at the same time. The higher priority card gets to transfer data first. 

DVP: Device Parameter. Device parameters pass special configuration information about the spe- 
cific devices to the driver. 

DVT: Device Table. This is the table that the system uses to keep information about the device 
transactions in progress. 
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EMI: Electro Magnetic Interference. 

Extended status: Sense code and additional sense code in DVT 19. 



Field Replaceable Unit (FRU): Any unit or part that customers can replace in the field for return 
to Hewlett-Packard for repair. 

File Management Package: A program in RTE that handles file access. 

Firmware: The card control program that resides in PROM on the card. 

Firmware timestamp: The year, month and day of the firmware release and firmware revision 
codes. 

IDQ35: Relocatable SCSI Interface Driver. 

IFT: Interface table. 

Interrupt priority: This determines how the system resolves which I/O card receives service if 
two cards request it at the same time. 

LEDs (Light Emitting Diodes): Four lights which indicate SCSI self-test results. The LEDs show 
whether or not the SCSI Card has passed the self-test, and if it has failed, the pattern of the lights 
indicates the reason for the self-test failure. 

Logical Unit (LU): A number that RTE assigns to each I/O device that was identified during sys- 
tem generation. 

On-line Verification Program: A program which runs under RTE. It verifi es correct operation of 
the I/O subsystem. 

RTAGN: The program that uses an answer file and RTE relocatables to make an RTE system. 
Runstring: The command given to RTE that indicates an action, for example, running a program. 

SCSI: Small Computer Systems Interface I. 

SCSI-II: Small Computer Systems Interface DL 

Sense code: This code provides drive error information in the lower byte (bits -7) of DVT 19. 

SW1: A bank of eight switches that specifies the select code of the card and enables SCSI bus 
terminal power from the card. 

SW2: A bank of eight switches that specifies the SCSI address. 
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Termination Power (TERMPWR): The SCSI signal that supplies power to the remote termination 
resistors. 



VCP Terminal: The Virtual Control Panel. Through the VCP, you can initiate boot up, access 
CPU registers and access memory locations. 

VSCSI: See glossary entry under On-line Verification Program. 



Welcome file: A program which configures the user environment that is executed when the user 
logs onto an RTE system. 
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Boot command file, 3-5 
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Command descriptor block (CDB), 5-4 
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Additional sense code, A-ll 
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Disk initialization, 4-5 

DMA priority, 2-7, 2-11 

Driver access, 5-1 

Drivers, 3-2 
Device support, 1-4 
Disk device (DDQ30), 3-2, 5-13 

Blocking factor, 5-15 

Buffer address, 5-13 

Buffer length, 5-14 

Bypass bit, 5-14 

Control word bits, 5-13 

Driver parameter table (DVP), 5-15 

Errors, A-3 

Read request, 5-13 

Sector address, 5-14 

Source code, 3-2 

Subfunction bits, 5-14 

Track address, 5-14 

Write request, 5-13 

Z-Buffer EXEC calls, 5-15 
Generation records, 3-2 
Interface (IDQ35), 3-2, 5-16 

DVT status, 5-17 

DVT transformation, 5-16 

Errors, A-4 
MACRO/1000 support routine, 3-2 
Partitions, 3-4 

Tape Device (DDQ24), Read request, 5-2 
Tape device (DDQ24), 3-2, 5-2 

Buffer address, 5-4 

Buffer length, 5-4 

Bypass bit, 5-3 

Command length, 5-4 

Commands, 5-4 

Control word bits, 5-2 

Error codes, 5-11 

Errors, A-l 

Extended transaction status, 5-12, A-2 

Subfunction bits, 5-3 

Transmission log, 5-12, A-2 

Write request, 5-2 

Z-Buffer read request, 5-2 

Z-Buffer write request, 5-2 
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EXEC calls 
Disk device driver (DDQ30), 5-13 
Disk device driver (DDQ30) Z-Buffer, 5-15 
Tape device driver (DDQ24), 5-2 

Extender cable, 1-3 



Optical disk drive errors, A-5 
Additional sense code, A-6 
Extended status, A-5 
Sense code, A-6 



Firmware timestamp, 4-9, 4-12 
Format a disk, 4-5 
Fuse, 2-7 



Partitions, 3-3 

Peripheral devices tested, 1-4 
Power requirements, 1-5 
Power supply load, 2-2 



Generate the system, 3-5 
Generation record, 1-2, 3-4 

I 

ID (SCSI Card) display, 4-8, 4-12 
Information display, 4-6, 4-11 
Initializing a disk, 4-5 
Interface table statements), 3-4 
Interrupt priority, 2-7, 2-11 



Layout of SCSI Card, 2-4 

LED (Light Emitting Diode) error patterns, 2-10, 
4-2 

LU list, 4-6, 4-11 

LU number range, 3-3 
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M 

Maximum disk size, 5-15 

Media options, 1-3 
1600 BPI Magnetic Tape, 1-3 
CS/80 Cartridge Tape, 1-3 
Microfloppy disks, 1-3 

Modular jack, 2-2 



Table generation, 3-4 

Termination power (TER1VIPWR), 1-5, 2-5, B-l, 
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UP command, 4-7 
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